IWbemEventProviderQuerySink::CancelQuery メソッド (wbemprov.h)

論理イベント コンシューマーが Windows Management で関連するイベント クエリ フィルターをキャンセルするたびに、 IWbemEventProviderQuerySink::CancelQuery メソッドを呼び出します。 CancelQuery メソッドは、イベント プロバイダーが関連する取り消されたイベント クエリ フィルターに応答する方法を決定します。 WMI がコンシューマーからイベント クエリ フィルターのキャンセル通知を取得するたびに、WMI は CancelQuery を呼び出して、責任あるイベント プロバイダーにキャンセルをエコーします。 イベント プロバイダーは、クエリの識別子を調べて、取り消されるクエリを判断できます。 その後、プロバイダーは、取り消しに基づいて送信されるイベントを変更します。

構文

HRESULT CancelQuery(
  [in] unsigned long dwId
);

パラメーター

[in] dwId

取り消されたクエリの識別子。 この識別子は、最初は、このインターフェイスの NewQuery メソッドによってプロバイダーに配信されました。

戻り値

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

解説

コンシューマーが新しいイベント クエリ フィルターを登録するたびに、Windows Management はクエリ識別子を使用して IWbemEventProviderQuerySink::NewQuery メソッドを呼び出します。 その後、そのクエリが登録解除されると、どのクエリが未処理でなくなったかを示すこのメソッドが呼び出されます。

プロバイダーは、このメソッドを使用して、内部的なイベントの生成を最適化します。

要件

関連項目

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery