BrowseCallbackProc

[Now Supported on Windows NT]

Specifies an application-defined callback function used with the SHBrowseForFolder function. The browse dialog box calls this function to notify it about events. The BFFCALLBACK type defines a pointer to this callback function.

int BrowseCallbackProc(

HWND hwnd,  
UINT uMsg,  
LPARAM lParam,  
LPARAM lpData  
);  

Parameters

hwnd

Handle to the browse dialog box. The callback function can send the following messages to this window:

BFFM_ENABLEOK Enables the OK button if the wParam parameter is nonzero or disables it if wParam is zero.
BFFM_SETSELECTION Selects the specified folder. The lParam parameter is the PIDL of the folder to select if wParam is FALSE, or it is the path of the folder otherwise.
BFFM_SETSTATUSTEXT Sets the status text to the null-terminated string specified by the lParam parameter.

uMsg

Value identifying the event. This parameter can be one of the following values:

BFFM_INITIALIZED The browse dialog box has finished initializing. lpData is NULL.
BFFM_SELCHANGED The selection has changed. lpData is a pointer to the item identifier list for the newly selected folder.

lParam

Message-specific value. For more information, see the description of uMsg.

lpData

Application-defined value that was specified in the lParam member of the BROWSEINFO structure.

Return Values

Returns zero.

See Also

BROWSEINFO