IWbemServices::QueryObjectSink メソッド (wbemcli.h)

  • [アーティクル]

IWbemServices::QueryObjectSink メソッドを使用すると、呼び出し元は Windows Management によってエクスポートされる通知ハンドラーを取得できます。 これにより、呼び出し元は通知とイベントを Windows Management に直接書き込みます。 呼び出し元は、Windows Management に対してのみ extrinsic イベントを書き込む必要があります。 詳細については、「受信するイベントの種類の決定」を参照してください。

構文

HRESULT QueryObjectSink(
  [in]  long            lFlags,
  [out] IWbemObjectSink **ppResponseHandler
);

パラメーター

[in] lFlags

予約済み。 このパラメーターは、0 にする必要があります。

[out] ppResponseHandler

通知ハンドラーへのインターフェイス ポインターを受け取ります。 これは、エラーが発生した場合に NULL を指す値に設定されます。 返されるポインターは正の参照カウントを持ち、呼び出し元は不要になったときにポインターで IWbemServices::Release を 呼び出す必要があります。 使用可能な通知ハンドラーがない場合は、 NULL 値を返すことができます。 これはエラーではありません。

メモppResponseHandler パラメーターの値は、このメソッドに渡されるときに NULL にすることはできません。
 

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。

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

メモQueryObjectSink を使用したイベントの発生は、既定では Administrators でのみ許可されます。 アクセス許可を他のユーザーに拡張するには、アクセス許可 WBEM_FULL_WRITE 付与する必要があります。
 

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー wbemcli.h (Wbemidl.h を含む)
Library Wbemuuid.lib
[DLL] Fastprox.dll;Esscli.dll;FrameDyn.dll;FrameDynOS.dll;Ntevt.dll;Stdprov.dll;Viewprov.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wbemsvc.dll;Wmipicmp.dll。Wmidcprv.dll;Wmipjobj.dll。Wmiprvsd.dll

関連項目

IWbemObjectSink

IWbemServices

WMI のクエリ