SHOpenWithDialog 関数 (shlobj_core.h)

[ファイルを 開く ] ダイアログ ボックスを表示します。

構文

SHSTDAPI SHOpenWithDialog(
  [in, optional] HWND             hwndParent,
  [in]           const OPENASINFO *poainfo
);

パラメーター

[in, optional] hwndParent

型: HWND

親ウィンドウのハンドル。 この値には NULL を指定できます。

[in] poainfo

型: const OPENASINFO*

結果のダイアログの内容を指定する OPENASINFO 構造体へのポインター。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

Windows 10以降、SHOpenWithDialog では、OAIF_ALLOW_REGISTRATION、OAIF_FORCE_REGISTRATION、およびOAIF_HIDE_REGISTRATIONフラグは無視されます。 [ ファイル拡張子を指定して開く ] ダイアログ ボックスを使用して、ファイル拡張子を開くために使用される既定のプログラムを変更できなくなりました。 SHOpenWithDialog を使用して 1 つのファイルを開くだけです。

SHOpenWithDialog がOAIF_EXEC渡さずに呼び出された場合、ユーザーには、ファイル拡張子を開くために使用される既定のプログラムを設定で変更できることを通知するダイアログが表示されます。

要件