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 を含む) |