IHandlerActivationHost::BeforeCoCreateInstance メソッド (shobjidl_core.h)

ハンドラーが作成されようとしていることを クライアントに ShellExecuteEx に 通知し、そのハンドラーの使用を確認する UI を表示したり、特定のエラー コードを返して拒否したりする機会をクライアントに与えます。

構文

HRESULT BeforeCoCreateInstance(
  [in] REFCLSID        clsidHandler,
  [in] IShellItemArray *itemsBeingActivated,
  [in] IHandlerInfo    *handlerInfo
);

パラメーター

[in] clsidHandler

ハンドラーを識別します。

[in] itemsBeingActivated

ハンドラーに渡されるシェル項目オブジェクト。 通常は 1 つだけですが、複数の場合があります。

[in] handlerInfo

呼び出されるハンドラーに関する情報へのアクセスを提供します。 このオブジェクトは、そのインターフェイスをサポートする Windows のバージョンでも IHandlerInfo2 をサポートしています。

戻り値

このメソッドは、成功すると S_OK を返します。 それ以外の場合は HRESULT エラー コードが返 されます。HRESULT_FROM_WIN32(ERROR_CANCELLED) は ShellExecute 呼び出しを取り消す必要があることを示 します。EXECUTE_E_LAUNCH_APPLICATION は、このハンドラーを使用しないことを示しますが、別のハンドラーがある場合は使用する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)

こちらもご覧ください

IHandlerActivationHost