IUnsecuredApartment::CreateObjectStub メソッド (wbemcli.h)

[アーティクル]
03/03/2024

CreateObjectStub メソッドは、Windows Management からの非同期呼び出しの受信を支援するオブジェクトフォワーダーシンクを作成します。この関数は、セキュリティで保護されていないオブジェクトシンクをローカルオブジェクトシンクにバインドして、COM セキュリティが CIM オブジェクトの非同期取得に干渉しないようにします。 COM セキュリティはバイパスされているため、リモート Windows 管理サーバーは信頼できるコンポーネントであると見なされます。

一般的なパラダイムは、クライアントプロセスでの IWbemObjectSink の元の実装が、IWbemServices への非同期呼び出しでは直接使用されないことです。代わりに、元の実装と代替オブジェクトの両方が作成され、バインドされ、 IWbemServices の非同期メソッドで substitute オブジェクトが使用されます。

構文

HRESULT CreateObjectStub(
  [in]  IUnknown *pObject,
  [out] IUnknown **ppStub
);

パラメーター

[in] pObject

クライアントの IWbemObjectSink のインプロセス実装へのポインター。

[out] ppStub

非同期 IWbemServices 呼び出しで使用される代替オブジェクトへのポインターを受け取ります。ユーザーは IUnknown ポインターを受け取り、非同期 IWbemServices 呼び出しでこのオブジェクトを使用する前に、IID_WbemObjectSinkの QueryInterface を呼び出す必要があります。

戻り値

このメソッドは、 QueryInterface の標準 COM エラーコードを返します。呼び出しが成功した場合は 、S_OK を返します。要求されたインターフェイスがサポートされていないために呼び出しが失敗した場合、メソッドは E_NOINTERFACEを返します。

ネットワークの問題によって Windows Management へのリモート接続が失われると、COM 固有のエラーコードも返される可能性があります。

注釈

メモシンクへのコールバックは、クライアントが必要とするのと同じ認証レベルで返されない可能性があるため、非同期通信の代わりに半同期を使用することをお勧めします。詳細については、「メソッドの呼び出し」を参照してください。

例

IUnsecuredApartment インターフェイスの使用方法を示す完全な例については、「例: WMI によるイベント通知の受信」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008 R2
対象プラットフォーム	Windows
ヘッダー	wbemcli.h (Wbemidl.h を含む)
Library	Wbemuuid.lib
[DLL]	Unsecapp.exe