CDM_GETSPEC сообщение

[Начиная с Windows Vista, общие диалоговые окна "Открыть" и "Сохранить как" заменены диалоговым окном "Общий элемент". Мы рекомендуем использовать API общих диалоговых окон вместо этих диалоговых окон из общей библиотеки диалоговых окон.]

Извлекает имя файла (не включая путь) к выбранному файлу в Обозреватель диалоговом окне Открыть или Сохранить как. Диалоговое окно должно быть создано с флагом OFN_EXPLORER ; В противном случае сообщение завершается ошибкой.

#define WM_USER                  0x0400
#define CDM_FIRST               (WM_USER + 100)
#define CDM_GETSPEC             (CDM_FIRST + 0x0000)

Параметры

wParam

Размер буфера lParam в символах.

lParam

Указатель на буфер, получающий имя файла.

Возвращаемое значение

Если сообщение завершается успешно, возвращаемое значение представляет собой размер строки имени файла в символах, включая завершающий символ NULL. Это либо количество байтов или символов, скопированных в буфер, либо требуемый размер буфера, если буфер слишком мал.

При возникновении ошибки возвращаемое значение меньше нуля.

Комментарии

Соответствующий макрос выглядит следующим образом:

int CommDlg_OpenSave_GetSpec(hwnd, lparam, wparam); 

Требования

См. также раздел

Справочные материалы

GetOpenFileName

GetSaveFileName

OPENFILENAME

Основные понятия

Общая библиотека диалоговых окон