класс __FilterToConsumerBinding

Статья
11/10/2023

Системный класс __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
Тип доступа: чтение и запись
Квалификаторы: ключ

Ссылка на экземпляр __EventConsumer , представляющий путь объекта к логическому потребителю, получателю события. Логический потребитель — это экземпляр класса, производный от __EventConsumer.

CreatorSID

Тип данных: массив uint8
Тип доступа: чтение и запись

Идентификатор безопасности (SID), который однозначно идентифицирует пользователя, создавшего привязку. В зависимости от операционной системы WMI сохраняет идентификатор безопасности Администратор istrator или идентификатор безопасности пользователя, создающего экземпляр __FilterToConsumerBinding. Дополнительные сведения см. в статье Привязка фильтра событий с логическим потребителем и мониторингом и реагированием на события с помощью стандартных потребителей.

DeliverSynchronously

Тип данных: логический
Тип доступа: чтение и запись

Является устаревшей. Вместо этого используйте свойство DeliveryQoS вместо этого свойства, так как если Для DeliverSynchronously задано значение True , оно переопределяет параметр свойства DeliveryQoS .

DeliveryQoS

Тип данных: uint32
Тип доступа: чтение и запись

Качество обслуживания для подписки. Если для свойства DeliverSynchronously задано значение True, он переопределяет параметр свойства DeliveryQoS.

WMIMSG_FLAG_QOS_SYNCHRONOUS (0)

Синхронная доставка

False. Событие передается логическому потребителю синхронно.

WMIMSG_FLAG_QOS_EXPRESS (1)

Экспресс-доставка

True. Событие передается логическому потребителю асинхронно.

Фильтр

Тип данных: __EventFilter
Тип доступа: чтение и запись
Квалификаторы: ключ

Ссылка на экземпляр __EventFilter , представляющий путь объекта к фильтру событий, который является запросом, указывающим тип полученного события.

MaintainSecurityContext

Тип данных: логический
Тип доступа: чтение и запись

Если значение True, события доставляются в том же контексте безопасности, что и поставщик, когда он предоставил их.

Примечание.

Только потребитель, реализованный в виде библиотеки DLL (внутрипроцессного потребителя), может получать события в контексте безопасности поставщика. Дополнительные сведения о поставщиках в процессе и безопасности см. в разделе "Размещение и безопасность поставщика". Дополнительные сведения и примеры см. в разделе "Замена:Получение событий безопасно".

SlowDownProviders

Тип данных: логический
Тип доступа: чтение и запись

Если значение True, поставщики замедляются, если этот потребитель не может продолжать работу.

Замечания

Класс __FilterToConsumerBinding является производным от __IndicationRelated, который не имеет свойств.

Постоянные потребители событий используют системный класс __FilterToConsumerBinding для привязки фильтров событий к конечным потребителям. После привязки фильтра и потребителя WMI может пересылать события, соответствующие фильтру соответствующему потребителю.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Все пространства имен WMI

См. также

__IndicationRelated
Системные классы WMI
Мониторинг и реагирование на события с помощью стандартных потребителей
Мониторинг событий
Создание фильтра событий
Защита событий WMI