CDM_GETFOLDERIDLIST

The CDM_GETFOLDERIDLIST message retrieves the address of the item identifier list corresponding to the folder that an Explorer-style Open or Save As common dialog box currently has open. The dialog box must have been created with the OFN_EXPLORER flag; otherwise, the message fails.

CDM_GETFOLDERIDLIST 
wParam = (WPARAM) cbmax; 
lParam = (LPARAM) (LPVOID) pidl; 
 
// Corresponding macro 
int CommDlg_OpenSave_GetFolderIDList(hdlg, pidl, cbmax); 
 

Parameters

hdlg

Handle of the common dialog box window to receive the message.

pidl

Pointer to the buffer that receives the list of item identifiers.

cbmax

Size, in bytes, of the pidl buffer.

Return Values

If the message succeeds, the return value is the size, in bytes, of the list of item identifiers. This is either the number of bytes copied to the pidl buffer, or the required buffer size if the buffer is too small.

If an error occurs, the return value is less than zero.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 1.0 or later.
  Header: Declared in commdlg.h.

See Also

Common Dialog Box Library Overview, Common Dialog Box Messages, GetOpenFileName, GetSaveFileName, OPENFILENAME