GetSaveFileName

BOOL GetSaveFileName( LPOPENFILENAME lpofn );

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

Если пользователь ввёл имя файла и нажал клавишу OK, возвращается ненулевое значение. Буфер, на который указывает переменная lpstrFile объекта структуры OPENFILENAME, содержит полный путь и имя файла, выделенного пользователем.

Если пользователь нажимает кнопку Отмена, закрывает диалоговое окно Сохранение файла или в процессе выполнения данной функции возникает ошибка, возвращается нулевое значение. Для получения расширенной информации об ошибке вызывается функция CommDlgExtendedError, возвращающая одно из следующих значений: CDERR_FINDRESFAILURE, CDERR_INITIALIZATION, CDERR_LOCKRESFAILURE, CDERR_LOADRESFAILURE, CDERR_LOADSTRFAILURE, CDERR_MEMALLOCFAILURE, CDERR_MEMLOCKFAILURE, CDERR_NOHINSTANCE, CDERR_NOHOOK, CDERR_NOTEMPLATE, CDERR_STRUCTSIZE, FNERR_BUFFERTOOSMALL, FNERR_INVALIDFILENAME и FNERR_SUBCLASSFAILURE.

Аргументы

0. lpofn — указатель на объект структуры OPENFILENAME, содержащий информацию, используемую при инициализации диалогового окна. После завершения работы функции GetSaveFileName данный объект структуры хранит информацию о выделенных пользователем файлах.

Примечание

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

По умолчанию в операционных системах Windows 95 и Windows NT версии 4.0 используется диалоговое окно Сохранение файла, имеющее стиль Windows Explorer. Для данного стиля окон используется функция обратного вызова формата OFNHookProc. Для использования функции обратного вызова следует установить флаги OFN_EXPLORER и OFN_ENABLEHOOK в переменной Flags объекта структуры OPENFILENAME и занести в переменную lpfnHook указатель на функцию обратного вызова.

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

Описание данной функции содержится в файле заголовка comdlg.h. При работе с данной функцией следует включить в проект библиотеку comdlg32.lib.

GetSaveFileNamePreview

BOOL GetSaveFileNamePreview( LPOPENFILENAME lpofn );

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

Возвращает дескриптор выбранного файла.

Аргументы

0. lpofn — указатель на объект структуры OPENFILENAME, используемый для инициализации диалогового окна. При успешном завершении функции в данном объекте структуры содержится информация о выбранном пользователем файле.

Примечание

Функция GetSaveFileNamePreview позволяет пользователю выбрать файл в диалоговом окне SaveAs. Данное диалоговое окно позволяет пользователю осуществить предварительный просмотр выделенного файла с расширением .avi. Данная функция позволяет расширить возможности функции GetSaveFileName.

Описание данной функции содержится в файле заголовка vfw.h. При работе с данной функцией следует включить в проект библиотеку vfw32.lib.