IWbemServices::QueryObjectSink method

The IWbemServices::QueryObjectSink method allows the caller to obtain a notification handler that is exported by Windows Management. This allows the caller to write notifications and events directly to Windows Management. The caller should only write extrinsic events to Windows Management. For more information, see Determining the Type of Event to Receive.

Syntax

HRESULT QueryObjectSink(
  long            lFlags,
  IWbemObjectSink **ppResponseHandler
);

Parameters

lFlags

Reserved. This parameter must be 0.

ppResponseHandler

Receives the interface pointer to the notification handler. This is set to point to NULL when there is an error. The returned pointer has a positive reference count, and the caller must call IWbemServices::Release on the pointer when it is no longer needed. A NULL value can be returned if no notification handler is available. This is not an error.

Note  The value of the ppResponseHandler parameter cannot be NULL when it is passed to this method.
 

Return Value

This method returns an HRESULT indicating the status of the method call. The following list lists the value contained withinan HRESULT.

COM-specific error codes also may be returned if network problems cause you to lose the remote connection to Windows Management.

Note  Firing events using QueryObjectSink is permitted by default for Administrators only. Extending the permission to other users requires giving them WBEM_FULL_WRITE permission.
 

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header wbemcli.h (include Wbemidl.h)
Library Wbemuuid.lib
DLL Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

See Also

IWbemObjectSink

IWbemServices

Querying WMI