Contains parameters for the the SHBrowseForFolder function and receives information about the folder selected by the user.
typedef struct _browseinfo {
HWND hwndOwner; // see below
LPCITEMIDLIST pidlRoot; // see below
LPSTR pszDisplayName; // see below
LPCSTR lpszTitle; // see below
UINT ulFlags; // see below
BFFCALLBACK lpfn; // see below
LPARAM lParam; // see below
int iImage; // see below
} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO;
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.
See Also