IServiceProvider

COM

IID6d5140c1-7436-11ce-8034-00aa006009fa継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IServiceProvider インターフェイスは、GUID で識別されるサービスを検索するための汎用的なアクセス機構を提供します。

解説(Remarks)

IServiceProvider インターフェイスは、コントロールやその他のオブジェクトを通じて提供される、GUID で識別されるサービスを検索するための汎用的なアクセス機構です。サービスは、このオブジェクトが通信できる任意のオブジェクトによって提供されます。たとえば、埋め込みオブジェクト(OLE コントロールなど)は通常、IOleObject::SetClientSite を使用して提供される IOleClientSite インターフェイスを介して、コンテナー内の関連するクライアントサイトオブジェクトとのみ通信します。埋め込みオブジェクトは、クライアントサイトに実装されていない可能性があるコンテナー提供の別のサービスを、クライアントサイトに要求する必要があります。

クライアントサイトは、そのサイトが管理するコントロールが必要に応じてサービスにアクセスできる手段を提供しなければなりません。たとえば、インプレースオブジェクトやコントロールは、IOleInPlaceSite::GetWindowContext) 関数を使用して、サイトを含むドキュメントオブジェクトや、そのドキュメントを含むフレームオブジェクトのインターフェイスポインターにアクセスできます。これらのインターフェイスポインターは別々のオブジェクト上に存在するため、コントロールはサイトの QueryInterface を呼び出してそれらのポインターを取得することはできません。代わりに IServiceProvider インターフェイスを使用します。

IServiceProvider インターフェイスには、単一のメソッド QueryService の 2 つのオーバーロードがあります。呼び出し元はこれを通じて、サービス ID(SID、GUID)、返されるインターフェイスの IID、および呼び出し元のインターフェイスポインター変数のアドレスを指定します。2 番目のオーバーロードは、メソッドに渡された出力ポインターから IID を推論します。

このインターフェイスの IID は IID_IServiceProvider です。

メソッド 1

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

vtbl 3 HRESULT QueryService(GUID* guidService, GUID* riid, void** ppvObject)

guidService	GUID*	in	要求するサービスを識別するサービス GUID を指定する。
riid	GUID*	in	取得するインターフェイスの識別子 (IID) を指定する。
ppvObject	void**	out	要求したサービスのインターフェイスへのポインタを受け取る変数へのポインタである。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IServiceProvider "{6D5140C1-7436-11CE-8034-00AA006009FA}"
#usecom global IServiceProvider IID_IServiceProvider "{}"
#comfunc global IServiceProvider_QueryService  3 var,var,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IServiceProvider "{6D5140C1-7436-11CE-8034-00AA006009FA}"
#usecom global IServiceProvider IID_IServiceProvider "{}"
#comfunc global IServiceProvider_QueryService  3 sptr,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。