IUnsecuredApartment
COM公式ドキュメント
IUnsecuredApartment インターフェイスは、クライアントプロセスから非同期呼び出しを行う処理を簡素化するために使用します。
解説(Remarks)
IUnsecuredApartment を使用すると、WMI がコールバックを処理するための別プロセスを作成できます。ただし、このインターフェイスの使用には Setting Security on an Asynchronous Call で説明されているセキュリティ上のリスクが伴います。非同期呼び出しの代わりに、半同期アクセスまたはアクセスチェックの実行を推奨します。IUnsecuredApartment の使用方法の詳細および例については、Lowering the Security for a Sink in a Separate Process を参照してください。より安全な方法としては IWbemUnsecuredApartment::CreateSinkStub を使用してください。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
CreateObjectStub メソッドは、Windows Management からの非同期呼び出しの受信を補助するオブジェクト転送シンクを作成します。
| pObject | IUnknown* | in | クライアントのインプロセス実装である IWbemObjectSink へのポインター。 |
| ppStub | IUnknown** | out | 非同期の IWbemServices 呼び出しで使用する代替オブジェクトへのポインターを受け取ります。ユーザーは IUnknown ポインターを受け取るため、このオブジェクトを非同期の IWbemServices 呼び出しで使用する前に、IID_WbemObjectSink に対して QueryInterface を呼び出す必要があります。 |
戻り値
このメソッドは QueryInterface の標準的な COM エラーコードを返します。呼び出しが成功した場合は S_OK を返します。要求されたインターフェイスがサポートされていないために呼び出しが失敗した場合は、E_NOINTERFACE を返します。
ネットワークの問題により Windows Management へのリモート接続が失われた場合は、COM 固有のエラーコードが返されることもあります。
解説(Remarks)
例
IUnsecuredApartment インターフェイスの使用方法を示す完全な例については、Example: Receiving Event Notifications Through WMI を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IUnsecuredApartment "{1CFABA8C-1523-11D1-AD79-00C04FD8FDFF}"
#usecom global IUnsecuredApartment IID_IUnsecuredApartment "{49BD2028-1523-11D1-AD79-00C04FD8FDFF}"
#comfunc global IUnsecuredApartment_CreateObjectStub 3 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。