GetSaveFileName函数创建一个保存公共对话框,允许用户指定要保存的文件的驱动器,目录和名称。
BOOL GetSaveFileName(
LPOPENFILENAME 【lpofn】 | //具有初始化数据的结构地址 |
); |
参数
【lpofn】
指向OPENFILENAME结构的指针,其中包含用于初始化对话框的信息。当GetSaveFileName返回时,此结构包含有关用户文件选择的信息。
返回值
如果用户指定文件名并单击确定按钮,则返回值不为零。OPENFILENAME结构lpstrFile成员指向的缓冲区包含用户指定的完整路径和文件名。
如果用户取消或关闭保存对话框或发生错误,返回值为零。要获取扩展错误信息,请调用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资源管理器的用户界面功能。您可以为Explorer风格的“保存”对话框提供一个OFNHookProc挂钩过程。要启用挂接过程,请在OPENFILENAME结构的旗成员中设置OFN_EXPLORER和OFN_ENABLEHOOK标志,并在lpfnHook成员中指定挂钩过程的地址。
Windows 95和Windows NT 4.0继续支持用于维护与Windows 3.1或Windows NT 3.51用户界面一致的用户界面的应用程序的旧式保存对话框。要显示旧样式的保存对话框,请启用OFNHookProcOldStyle挂接过程,并确保未设置OFN_EXPLORER标志。
也可以看看
CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME