GetSaveFileName

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

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

Параметры

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

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

Если пользователь указывает имя файла и нажимает кнопку « ОК », возвращается ненулевое значение. Буфер, который указывает член lpstrFile структуры OPENFILENAME содержит полный путь и имя файла, указанного пользователем.

Если пользователь отменит или закроет диалоговое окно Сохранение или возникает ошибка, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите функцию 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 отображать новую версию сохранить диалогового окна, предоставляет возможности интерфейса пользователя, наподобие проводника Windows. Вы можете предоставить процедуру подключения OFNHookProc для диалогового окна проводника стиле, сохранить . Чтобы включить процедуру подключения, установите флаги OFN_EXPLORER и OFN_ENABLEHOOK в флаги член OPENFILENAME структуры и указать адрес процедуру подключения в lpfnHook член.

Windows 95 и Windows NT 4.0 по-прежнему поддерживать старых диалоговое окно Сохранение для приложений, которые хотят поддерживать интерфейс пользователя в соответствии с Windows 3.1 или Windows NT 3.51-интерфейсом пользователя. Чтобы отобразить диалоговое окно Сохранение старого стиля, включить процедуру подключения OFNHookProcOldStyle и не установлен флаг OFN_EXPLORER.

Windows CE: Не все члены структуры OPENFILENAME определены в Windows CE. Дополнительные сведения о определенных членов в разделе для OPENFILENAME структуры.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в commdlg.h.
Импорта библиотеки:Используйте comdlg32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Общие диалогового окна Обзор библиотеки, Общие функции диалогового окна Box, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME

Index