getFileNameFromBrowse 函数 (shlobj.h)

[此函数可通过 Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 获得。 在后续版本的 Windows 中,它可能已更改或不可用。]

创建“ 打开 ”对话框,以便用户可以指定要打开的文件的驱动器、目录和名称。

语法

BOOL GetFileNameFromBrowse(
  [in, optional] HWND   hwnd,
  [in, out]      PWSTR  pszFilePath,
                 UINT   cchFilePath,
  [in, optional] PCWSTR pszWorkingDir,
  [in]           PCWSTR pszDefExt,
  [in, optional] PCWSTR pszFilters,
  [in, optional] PCWSTR pszTitle
);

参数

[in, optional] hwnd

类型:HWND

拥有对话框的窗口的句柄。 此成员可以是任何有效的窗口句柄,如果对话框没有所有者,则它可以为 NULL

[in, out] pszFilePath

类型: PWSTR

一个以 null 结尾的 Unicode 字符串,其中包含用于初始化“文件名”编辑控件的文件名。 此字符串对应于 OPENFILENAME 结构的 lpstrFile 成员,并且以完全相同的方式使用。

cchFilePath

类型: UINT

pszFilePath 中的字符数,包括终止 null 字符。

[in, optional] pszWorkingDir

类型: PCWSTR

初始目录的完全限定文件路径。 此字符串对应于 OPENFILENAME 结构的 lpstrInitialDir 成员,并且以完全相同的方式使用。

[in] pszDefExt

类型: PCWSTR

包含默认文件扩展名的以 null 结尾的 Unicode 字符串。 如果用户未指定扩展,则会将此扩展添加到 pszFilePath 。 字符串不应包含任何“.”字符。 如果此字符串为 NULL ,并且用户无法键入扩展,则不会追加任何扩展。

[in, optional] pszFilters

类型: PCWSTR

定义筛选器的以 null 结尾的 Unicode 字符串。 此字符串对应于 OPENFILENAME 结构的 lpstrFilter 成员,并且以完全相同的方式使用。

[in, optional] pszTitle

类型: PCWSTR

一个以 null 结尾的 Unicode 字符串,放置在对话框的标题栏中。 如果此值为 NULL,则系统会使用默认标题。

返回值

类型: BOOL

如果用户指定文件名并单击“ 确定”,则返回值为 TRUEpszFilePath 指向的缓冲区包含用户指定的完整路径和文件名。 如果用户取消或关闭“ 打开 ”对话框或发生错误,则返回值为 FALSE

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlobj.h (包括 Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (5.0 或更高版本)

另请参阅

GetOpenFileName