CDM_GETSPEC
[New
- Windows NT]
The CDM_GETSPEC
message retrieves the filename (not including the path) of the currently
selected file in an Explorer-style Open or Save As common dialog box. The
dialog box must have been created with the OFN_EXPLORER flag; otherwise, the
message fails.
CDM_GETSPEC
wParam = (WPARAM) cbmax;
lParam = (LPARAM) (LPTSTR) psz;
// Corresponding macro
int CommDlg_OpenSave_GetSpec(hdlg, psz, cbmax);
Parameters
hdlg
Handle of the
common dialog box window to receive the message.
psz
Address of
the buffer that receives the filename.
cbmax
Size, in
bytes (ANSI version) or characters (Unicode version), of the psz buffer.
Return Values
If the
message succeeds, the return value is the size, in bytes or characters, of the
filename string, including the terminating NULL character. This is either the
number of bytes or characters copied to the psz 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