Метод IWbemUnboundObjectSink::IndicateToConsumer (wbemprov.h)
Метод IWbemUnboundObjectSink::IndicateToConsumer вызывается WMI для фактической доставки событий потребителю. С точки зрения реализации , IndicateToConsumer содержит код для обработки событий, получаемых приемником.
Синтаксис
HRESULT IndicateToConsumer(
[in] IWbemClassObject *pLogicalConsumer,
[in] long lNumObjects,
[in] IWbemClassObject **apObjects
);
Параметры
[in] pLogicalConsumer
Указатель на логический объект-получатель, для которого доставляется этот набор объектов.
[in] lNumObjects
Количество объектов, доставленных в следующем массиве.
[in] apObjects
Указатель на массив экземпляров IWbemClassObject , которые представляют доставленные события. Так как каждый объект в массиве соответствует отдельному событию, реализация IndicateToConsumer должна обрабатывать каждый объект отдельно.
Возвращаемое значение
Этот метод возвращает WBEM_S_NO_ERROR в случае успешного выполнения. В противном случае реализация должна возвращать соответствующий код ошибки.
Комментарии
WMI обычно получает указатель IWbemUnboundObjectSink для конкретного логического потребителя от поставщика потребителя событий, который реализует интерфейс IWbemEventConsumerProvider . Затем управление Windows вызывает Метод IndicateToConsumer для доставки фактических объектов событий.
В большинстве реализаций IndicateToConsumer предполагается, что уведомление является асинхронным. Для поддержки синхронных уведомлений приемник должен завершить обработку событий менее чем за 20 миллисекундах. Чрезвычайно быстрые поставщики потребителей событий, поддерживающие синхронное уведомление, не должны содержать указатель на интерфейс IWbemClassObject или увеличивать число ссылок указателя в IndicateToConsumer. Если для Объекта Класса, определенного IWbemClassObject , требуется объект класса, превышающий время существования вызова IndicateToConsumer , создайте копию объекта . Однако если требуется долгосрочный доступ к сведениям, на которые указывает указатель IWbemClassObject , рекомендуется, чтобы поставщик потребителей событий не поддерживал синхронное уведомление. Поставщики потребителей событий указывают тип уведомлений, которые они поддерживают по завершении регистрации.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wbemprov.h (включая Wbemidl.h) |
| Библиотека | Wbemuuid.lib |
| DLL | Fastprox.dll |