ホーム › UI.Shell › IHandlerActivationHost

IHandlerActivationHost

COM

IID35094a87-8bb1-4237-96c6-c417eebdb078継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

。 (IHandlerActivationHost)

解説(Remarks)

このインターフェイスは、ShellExecuteEx またはコンテキストメニューハンドラーによって提供されるサイトチェーンを通じて到達可能なオブジェクトによって実装されます。アプリケーションは、サービス ID SID_SHandlerActivationHost を要求されたときに、IServiceProvider::QueryService の実装でこのオブジェクトを返します。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT BeforeCoCreateInstance(GUID* clsidHandler, IShellItemArray* itemsBeingActivated, IHandlerInfo* handlerInfo)

。 (IHandlerActivationHost.BeforeCoCreateInstance)

clsidHandler	GUID*	in	ハンドラーを識別します。
itemsBeingActivated	IShellItemArray*	in	ハンドラーに渡される Shell アイテムオブジェクトです。通常は 1 つのみですが、場合によっては複数になることがあります。
handlerInfo	IHandlerInfo*	in	呼び出されるハンドラーに関する情報へのアクセスを提供します。このオブジェクトは、IHandlerInfo2 をサポートするバージョンの Windows では、そのインターフェイスもサポートします。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。HRESULT_FROM_WIN32(ERROR_CANCELLED) は ShellExecute の呼び出しをキャンセルすべきであることを示し、EXECUTE_E_LAUNCH_APPLICATION はこのハンドラーを使用すべきではないが、別のハンドラーがあればそれを使用すべきであることを示します。

vtbl 4 HRESULT BeforeCreateProcess(LPWSTR applicationPath, LPWSTR commandLine, IHandlerInfo* handlerInfo)

。 (IHandlerActivationHost.BeforeCreateProcess)

applicationPath	LPWSTR	in	プロセス実行可能ファイルへの完全修飾パス、または場合によっては DLL のパスです。
commandLine	LPWSTR	in	CreateProcess に渡される完全なコマンドラインです。ハンドラーがその登録を通じて要求した引数も含まれます。
handlerInfo	IHandlerInfo*	in	呼び出されるハンドラーに関する情報へのアクセスを提供します。このオブジェクトは、IHandlerInfo2 をサポートするバージョンの Windows では、そのインターフェイスもサポートします。また、このオブジェクトは IObjectWithSelection も実装します。これを使用すると、起動される Shell アイテム、または場合によっては複数のアイテムを取得できます。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。HRESULT_FROM_WIN32(ERROR_CANCELLED) は ShellExecute の呼び出しをキャンセルすべきであることを示します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IHandlerActivationHost "{35094A87-8BB1-4237-96C6-C417EEBDB078}"
#usecom global IHandlerActivationHost IID_IHandlerActivationHost "{}"
#comfunc global IHandlerActivationHost_BeforeCoCreateInstance  3 var,sptr,sptr
#comfunc global IHandlerActivationHost_BeforeCreateProcess     4 wstr,wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IHandlerActivationHost "{35094A87-8BB1-4237-96C6-C417EEBDB078}"
#usecom global IHandlerActivationHost IID_IHandlerActivationHost "{}"
#comfunc global IHandlerActivationHost_BeforeCoCreateInstance  3 sptr,sptr,sptr
#comfunc global IHandlerActivationHost_BeforeCreateProcess     4 wstr,wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。