IWbemUnboundObjectSink::IndicateToConsumer 方法 (wbemprov.h)

WMI 调用 IWbemUnboundObjectSink::IndicateToConsumer 方法,以实际向使用者传递事件。 从实现的角度来看, 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 通常从实现 IWbemEventConsumerProvider 接口的事件使用者提供程序获取特定逻辑使用者的 IWbemUnboundObjectSink 指针。 然后,Windows 管理调用 IndicateToConsumer 来传递实际的事件对象。

IndicateToConsumer 的大多数实现都假定通知是异步的。 若要支持同步通知,接收器必须在不到 20 毫秒内完成事件处理。 支持同步通知的极快事件使用者提供程序不得持有指向 IWbemClassObject 接口的指针或递增 IndicateToConsumer 中的指针引用计数。 如果 IndicateToConsumer 需要 IWbemClassObject 定义的类对象超出 IndicateToConsumer 调用的生存期,请复制该对象。 但是,如果必须长期访问 IWbemClassObject 指针指向的信息,建议事件使用者提供程序不支持同步通知。 事件使用者提供程序指示他们在完成注册时支持的通知类型。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemprov.h (包括 Wbemidl.h)
Library Wbemuuid.lib
DLL Fastprox.dll

另请参阅

IWbemEventConsumerProvider

IWbemUnboundObjectSink