(ПолучитьСохраненноеИмяФайла)

Функция GetSaveFileName создает стандартное диалоговое окно Сохранить (Save), которое позволяет пользователю определить диск, каталог и имя файла, которое нужно сохранить.

Синтаксис

BOOL GetSaveFileName
(
    LPOPENFILENAME lpofn 	// адрес структуры данными инициализации
);

Параметры
lpofn
Указатель на структуру OPENFILENAME, которая содержит информацию, используемую, чтобы инициализировать диалоговое окно. Когда GetSaveFileName возвращает значение, эта структура содержит информацию о выбранном пользователем файле.

Возвращаемые значения
Если пользователь определяет имя файла и щелкает мышью по кнопке OK, возвращаемое значение не нуль. Буфер, указанный в элементе lpstrFile структуры OPENFILENAME содержит полный путь и имя файла, определенного пользователем.
Если пользователь прерывает работу или закрывает диалоговое окно Сохранить (Save) или происходит ошибка, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите функцию CommDlgExtendedError, которая может возвратить одно из ниже перечисленных значений:

CDERR_FINDRESFAILURE	CDERR_NOHINSTANCE
CDERR_INITIALIZATION	CDERR_NOHOOK
CDERR_LOCKRESFAILURE	CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE	CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE	FNERR_BUFFERTOOSMALL
CDERR_MEMALLOCFAILURE	FNERR_INVALIDFILENAME
CDERR_MEMLOCKFAILURE	FNERR_SUBCLASSFAILURE

Замечания
По умолчанию, Windows 95 и Windows NT версии 4.0 показывают новую версию диалогового окна Сохранить (Save), чтобы обеспечить пользовательский интерфейс со свойствами, которые похожи на Проводник Windows. Вы можете обеспечить диалоговое окно Сохранить (Save) в стиле Проводника фильтр - процедурой OFNHookProc. Чтобы разрешить работу фильтр - процедуры, установите флажки OFN_EXPLORER и OFN_ENABLEHOOK в элементе Flags структуры OPENFILENAME и установить ее адрес в элементе lpfnHook.
Windows 95 и Windows NT 4.0 продолжает поддерживать диалоговое окно Сохранить (Save) старого стиля для прикладных программ, которые хотят поддерживать пользовательский интерфейс совместимый с пользовательским интерфейсом Windows 3.1 или Windows NT 3.51. Чтобы показать диалоговое окно Сохранить (Save) в старом стиле, разрешите работу фильтр - процедуре OFNHookProcOldStyle и гарантируйте, что флажок OFN_EXPLORER не установлен.

Смотри также
CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME

Размещение и совместимость GetSaveFileName

Windows NT			Да 
Win95				Да 
Win32s				Да 
Импортируемая библиотека		comdlg32.lib 
Заголовочный файл			commdlg.h 
Уникод				WinNT 
Замечания по платформе		Не имеется