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) |
程式庫 | Wbemuuid.lib |
Dll | Fastprox.dll |