IAgileObject

COM

IID94ea2b94-e9cc-49e0-c0ff-ee64ca8f5b90継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IAgileObject (objidlbase.h) インターフェイスは、インターフェイスがアパートメントをまたいでアジャイルであることを示します。

解説(Remarks)

IAgileObject インターフェイスは、オブジェクトがフリースレッドであり、任意のアパートメントから呼び出せることを示すマーカーインターフェイスです。

Free Threaded Marshaler (FTM) を集約する場合とは異なり、IAgileObject インターフェイスを実装しても、呼び出しをマーシャリングする際の動作には影響しません。代わりに、IAgileObject インターフェイスは Global Interface Table (GIT) によって認識されます。IAgileObject インターフェイスを実装するオブジェクトが GIT に配置され、別のアパートメントにローカライズされると、そのオブジェクトはマーシャリングを行うのではなく、新しいアパートメントで直接呼び出されます。

メソッド 0

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

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAgileObject "{94EA2B94-E9CC-49E0-C0FF-EE64CA8F5B90}"
#usecom global IAgileObject IID_IAgileObject "{}"
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。