GetFileNameFromBrowse 函式 (shlobj_core.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_core.h (包含 Shlobj.h)
程式庫	Shell32.lib
Dll	Shell32.dll (5.0 版或更新版本)

另請參閱

GetOpenFileName