IWbemEventSink インターフェイス (wbemprov.h)
IWbemEventSink インターフェイスは、制限付きのクエリ セットを使用して、イベント プロバイダーとの通信を開始します。 このインターフェイスは、IWbemObjectSink を拡張して、セキュリティとパフォーマンスを扱う新しいメソッドを提供するものです。 このインターフェイスの使用に関する詳細については、「イベント プロバイダーの作成」と「WMI イベントのセキュリティ保護」を参照してください。
継承
IWbemEventSink インターフェイスは、IUnknown インターフェイスから継承します。 IWbemEventSink には、次の種類のメンバーもあります。
メソッド
IWbemEventSink インターフェイスには、次のメソッドがあります。
| IWbemEventSink::GetRestrictedSink IWbemEventSink::GetRestrictedSink メソッドは、制限されたイベント シンクを取得します。 制限付きイベント シンクは、イベント プロバイダーの登録で定義されているイベントのサブセットをフィルター処理するシンクです。 |
| IWbemEventSink::IsActive IWbemEventSink::IsActive メソッドは、シンクがフィルター処理しているイベントに関心があるかどうかを判断するためにプロバイダーによって使用されます。 |
| IWbemEventSink::SetBatchingParameters IWbemEventSink::SetBatchingParameters メソッドを使用して、最大イベント バッファー サイズとそれに関連付けられている処理待機時間の値を設定します。 |
| IWbemEventSink::SetSinkSecurity 通過するすべてのイベントのシンクにセキュリティ記述子 (SD) を設定するために使用します。 |
注釈
イベント サブスクリプション シンク (IWbemObjectSink または IWbemEventSink) を実装するときは、シンク オブジェクトのメソッド内から WMI を呼び出さないでください。 たとえば、IWbemServices::CancelAsyncCall を呼び出して IWbemEventSink::SetSinkSecurity の実装内からシンクを取り消すと、WMI の状態が妨げられる可能性があります。 イベント サブスクリプションを取り消すには、フラグを設定し、IWbemServices::CancelAsyncCall を別のスレッドまたはオブジェクトから呼び出します。 オブジェクト、列挙型、クエリの取得など、イベント シンクに関連しない実装の場合は、WMI にコールバックできます。
イベント通知を配信する WMI スレッドはシンク オブジェクトの処理が完了するまで他の処理を実行できないため、シンクの実装ではイベント通知を 100 ミリ秒内で処理する必要があります。 通知で大量の処理が必要な場合、シンクは内部キューを別のスレッドで使用して処理を操作することができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wbemprov.h (Wbemidl.h を含む) |