CDM_GETFOLDERIDLIST

[New - Windows NT]

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.

See Also

GetOpenFileName, GetSaveFileName, OPENFILENAME