__FilterToConsumerBinding クラス

  • [アーティクル]

__FilterToConsumerBinding システム クラスは、永続的なイベント コンシューマーの登録で使用され、__EventConsumer のインスタンスを __EventFilter のインスタンスに関連付けます。__FilterToConsumerBinding は関連付けクラスです。

次の構文は、マネージド オブジェクト フォーマット (MOF) コードを簡素化しており、継承されたすべてのプロパティを含んでいます。 プロパティは、MOF 順ではなくアルファベット順で一覧表示されています。

構文

class __FilterToConsumerBinding : __IndicationRelated
{
  __EventConsumer REF Consumer;
  uint8               CreatorSID[];
  boolean             DeliverSynchronously = False;
  uint32              DeliveryQoS;
  __EventFilter   REF Filter;
  boolean             MaintainSecurityContext = False;
  boolean             SlowDownProviders = False;
};

メンバー

__FilterToConsumerBinding クラスには、次の種類のメンバーがあります。

プロパティ

__FilterToConsumerBinding クラスには、次のプロパティがあります。

コンシューマー

データ型: __EventConsumer

アクセスの種類: 読み取り/書き込み

修飾子: Key

論理コンシューマー (イベントの受信者) へのオブジェクト パスを表す __EventConsumer のインスタンスへの参照。 論理コンシューマーは、__EventConsumer から派生したクラスのインスタンスです。

CreatorSID

データ型: uint8 配列

アクセスの種類: 読み取り/書き込み

バインドを作成するユーザーを一意に識別するセキュリティ識別子 (SID)。 WMI では、オペレーティング システムに応じて、管理者の SID、または __FilterToConsumerBinding のインスタンスを作成するユーザーの SID が格納されます。 詳細については、「論理コンシューマーを使用してイベント フィルターをバインドする」と「標準コンシューマーを使用したイベントの監視と対応」を参照してください。

DeliverSynchronously

データ型: boolean

アクセスの種類: 読み取り/書き込み

互換性のために残されています。 DeliverSynchronously が True に設定されている場合、DeliveryQoS プロパティの設定がオーバーライドされるため、このプロパティの代わりに DeliveryQoS プロパティが使用されます。

DeliveryQoS

データ型: uint32

アクセスの種類: 読み取り/書き込み

サブスクリプションのサービスの品質。 DeliverSynchronously プロパティが True に設定されている場合、DeliveryQoS プロパティの設定がオーバーライドされます。

WMIMSG_FLAG_QOS_SYNCHRONOUS (0)

同期配信

[False] 。 イベントは論理コンシューマーに同期的に配信されます。

WMIMSG_FLAG_QOS_EXPRESS (1)

高速配信

[True] 。 イベントは論理コンシューマーに非同期的に配信されます。

Assert

データ型: __EventFilter

アクセスの種類: 読み取り/書き込み

修飾子: Key

受信するイベントの種類を指定するクエリであるイベント フィルターへのオブジェクト パスを表す __EventFilter のインスタンスへの参照。

MaintainSecurityContext

データ型: boolean

アクセスの種類: 読み取り/書き込み

True の場合、イベントはプロバイダーがイベントを生成したときと同じセキュリティ コンテキストで配信されます。

Note

DLL (インプロセス コンシューマー) として実装されたコンシューマーのみが、プロバイダーのセキュリティ コンテキストでイベントを受信できます。 インプロセス プロバイダーとセキュリティについて詳しくは、「プロバイダーのホスティングとセキュリティ」を参照してください。 詳細と例については、「安全にイベントを受信する」を参照してください。

SlowDownProviders

データ型: boolean

アクセスの種類: 読み取り/書き込み

True の場合、このコンシューマーが追いつくことができないと、プロバイダーの速度が低下します。

解説

__FilterToConsumerBinding クラスは、プロパティを持たない __IndicationRelated から派生します。

永続的なイベント コンシューマーは、__FilterToConsumerBinding システム クラスを使用して、イベント フィルターを最終的なコンシューマーにバインドします。 フィルターとコンシューマーがバインドされると、WMI はフィルターに合致するイベントを対応するコンシューマーに転送できます。

例

TechNet ギャラリーにあるファイルを監視するための永続的な WMI イベント登録の作成に関する PowerShell サンプルでは、__FilterToConsumerBinding を複雑なスクリプトの一部として使用して、永続的な WMI イベント登録を設定します。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista
サポートされている最小のサーバー
 Windows Server 2008
名前空間
 すべての WMI 名前空間

関連項目

__IndicationRelated

WMI システム クラス

標準コンシューマーを使用したイベントの監視と対応

イベントの監視

イベント フィルターの作成

WMI イベントのセキュリティ保護