IInitializeCommand
COM公式ドキュメント
アプリケーションが指定したコマンド名と、その登録済みプロパティを使用して、IExplorerCommandState、IExecuteCommand、または IDropTarget を実装するオブジェクトを初期化するための単一のメソッドを公開します。
解説(Remarks)
実装するタイミング
次の状況で IInitializeCommand を実装します。- このインターフェイスを実装すると、IExplorerCommandState、IDropTarget、または IExecuteCommand の実装を共有する関連コマンドを区別できます。区別は、IInitializeCommand::Initialize に渡されるコマンド名によって行われます。コマンドは、レジストリに配置したプロパティを使用して、Initialize によってそのコマンド固有のプロパティバッグを渡すこともできます。
使用するタイミング
IInitializeCommand のメソッドを直接呼び出さないでください。このインターフェイスを実装する verb オブジェクトが呼び出されたときに、Windows エクスプローラーがこのメソッドを呼び出します。メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT Initialize(LPWSTR pszCommandName, IPropertyBag* ppb)
アプリケーションが指定したコマンド名と、その登録済みプロパティを使用して、IExplorerCommandState、IExecuteCommand、または IDropTarget の実装を共有するオブジェクトを初期化します。
| pszCommandName | LPWSTR | in | コマンド名(レジストリに登録されているコマンドキーの名前)を格納した文字列へのポインター。たとえば、コマンドが ...\shell\MyCommand の下に登録されている場合、pszCommandName は "MyCommand" を指します。 |
| ppb | IPropertyBag* | in | レジストリ内のコマンドに関連するプロパティを読み取るために使用できる IPropertyBag インスタンスへのポインター。たとえば、コマンドはその ...\shell\MyCommand サブキーの下に文字列プロパティを登録できます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IInitializeCommand "{85075ACF-231F-40EA-9610-D26B7B58F638}"
#usecom global IInitializeCommand IID_IInitializeCommand "{}"
#comfunc global IInitializeCommand_Initialize 3 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。