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