SHBrowseForFolder

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library

Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

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

WINSHELLAPI LPITEMIDLIST WINAPI SHBrowseForFolder(

LPBROWSEINFO lpbi
);

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.