Displays a dialog box that enables the user to select a shell folder.

Parameters
 
lpbi
 
Pointer to a BROWSEINFO structure that contains information used to display the dialog box.
 
 
 
Return Values
 
Returns a pointer to an item identifier list that specifies the location of the selected folder relative to the root of the name space. If the user chooses the Cancel button in the dialog box, the return value is NULL.
The calling application is responsible for freeing the returned item identifier list using the shell's task allocator.
 
See Also
 
BROWSEINFO  

Contains parameters for the the SHBrowseForFolder function and receives information about the folder selected by the user.

 
Members
 
hwndOwner
 
Handle of the owner window for the dialog box.
 
pidlRoot
 
Pointer to an item identifier list (an ITEMIDLIST structure) specifying the location of the "root" folder to browse from. Only the specified folder and its subfolders appear in the dialog box. This member can be NULL, and in that case, the name space root (the desktop folder) is used.
 
pszDisplayName
 
Pointer to a buffer that receives the display name of the folder selected by the user. The size of this buffer is assumed to be MAX_PATH bytes.
 
lpszTitle
 
Pointer to a null-terminated string that is displayed above the tree view control in the dialog box. This string can be used to specify instructions to the user.
 
ulFlags
 
Value specifying the types of folders to be listed in the dialog box as well as other options. This member can include zero or more of the following values:
 
BIF_BROWSEFORCOMPUTER Only returns computers. If the user selects anything other than a computer, the OK button is grayed.
BIF_BROWSEFORPRINTER Only returns printers. If the user selects anything other than a printer, the OK button is grayed.
BIF_DONTGOBELOWDOMAIN Does not include network folders below the domain level in the tree view control.
BIF_RETURNFSANCESTORS Only returns file system ancestors. If the user selects anything other than a file system ancestor, the OK button is grayed.
BIF_RETURNONLYFSDIRS Only returns file system directories. If the user selects folders that are not part of the file system, the OK button is grayed.
BIF_STATUSTEXT Includes a status area in the dialog box. The callback function can set the status text by sending messages to the dialog box.
 
 
lpfn
 
Address an application-defined function that the dialog box calls when events occur. For more information, see the description of the BrowseCallbackProc function. This member can be NULL.
 
lParam
 
Application-defined value that the dialog box passes to the callback function (if one is specified).
 
iImage
 
Variable that receives the image associated with the selected folder. The image is specified as an index to the system image list.