SHBrowseForFolder (Windows CE 5.0)

Article
09/14/2012

This function displays a dialog box that allows a user to select a folder.

Syntax

LPITEMIDLIST WINAPI SHBrowseForFolder(LPBROWSEINFOlpbi);

Parameters

lpbi
[in] Pointer to a BROWSEINFO structure that contains information used to display the dialog box.

Return Values

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.

Remarks

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.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Shlobj.h.
Link Library: Ceshell.lib.