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

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

要求

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

另请参阅

GetOpenFileName