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

ユーザーがファイル名を指定し、[ OK] をクリックすると、戻り値は TRUE になります。 pszFilePath が指すバッファーには、ユーザーが指定する完全なパスとファイル名が含まれています。 ユーザーが [ 開く ] ダイアログ ボックスをキャンセルまたは閉じるか、エラーが発生した場合、戻り値は FALSE です。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 5.0 以降)

関連項目

GetOpenFileName