Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function displays a dialog box that allows a user to select a folder.
LPITEMIDLIST WINAPI SHBrowseForFolder(
LPBROWSEINFO lpbi
);
- lpbi
[in] Pointer to a BROWSEINFO structure that contains information used to display the dialog box.
The return value is a pointer to an ITEMIDLIST structure (PIDL) that specifies the location of the folder that the user selected relative to the root of the namespace. NULL indicates that the user chose the Cancel button in the dialog box.
You should call the InitCommonControls function before calling SHBrowseForFolder.
The calling application is responsible for freeing the returned PIDL with the IMalloc::Free method for the shell allocator. To get a handle to the IMalloc:IUnknown interface for the shell's allocator, call SHGetMalloc.
If you implement a callback function, you receive a handle to the dialog box. You can use this window handle to modify the layout or the contents of the dialog box.
| Header | shlobj.h |
| Library | ceshell.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
Standard Shell Functions
BrowseCallbackProc
InitCommonControls
SHGetMalloc
BROWSEINFO
ITEMIDLIST