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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	shlobj.h (包含 Shlobj.h)
程式庫	Shell32.lib
Dll	Shell32.dll (5.0 版或更新版本)

另請參閱

GetOpenFileName