IWbemObjectSink::Indicate

[This is preliminary documentation and subject to change.]

The IWbemObjectSink::Indicate method is called by a source to provide a notification. The number of objects in the array depends upon the type of event notification. See WBEM Events.

Use this interface and method in conjunction with the asynchronous methods of the IWbemServices interface.

Clients and providers must implement this interface to receive notifications or to execute the asynchronous methods of IWbemServices.

HRESULT IWbemObjectSink::Indicate(
  [in] LONG lObjectCount,
  [in, size_is(1ObjectCount)] IWbemClassObject **ppObjArray
);
 

Parameters

lObjectCount
The number of objects in the following array of pointers.
ppObjArray
An array of pointers to IWbemClassObject interfaces. The array memory itself is read-only, and is owned by the caller of the method. Since this is an in-parameter, the interface called has the option of calling IWbemServices::AddRef on any object pointer in the array and holding it before returning. The interface called is only required to copy and then call IWbemServices::AddRef on the pointers if the pointers will be used after the call returns, according to COM rules. The interface called should not call Release on the objects without corresponding calls to AddRef. For more information on the IUnknown Interface methods, see the Microsoft Platform SDK.

Return Values

WBEM_E_FAILED The receiver was not able to process the notification properly.
WBEM_E_INVALID_PARAMETER An invalid parameter was specified, or the namespace could not be parsed.
WBEM_E_OUT_OF_MEMORY There was not enough memory to complete the operation.
WBEM_NO_ERROR The call succeeded; the receiver acknowledges the notification.