IWbemServices::QueryObjectSink-Methode (wbemcli.h)

Artikel
08/27/2023

Mit der IWbemServices::QueryObjectSink-Methode kann der Aufrufer einen Benachrichtigungshandler abrufen, der von der Windows-Verwaltung exportiert wird. Dadurch kann der Aufrufer Benachrichtigungen und Ereignisse direkt in die Windows-Verwaltung schreiben. Der Aufrufer sollte nur extrinsische Ereignisse in die Windows-Verwaltung schreiben. Weitere Informationen finden Sie unter Bestimmen des Typs des zu empfangenden Ereignisses.

Syntax

HRESULT QueryObjectSink(
  [in]  long            lFlags,
  [out] IWbemObjectSink **ppResponseHandler
);

Parameter

[in] lFlags

Reserviert. Dieser Parameter muss 0 sein.

[out] ppResponseHandler

Empfängt den Schnittstellenzeiger auf den Benachrichtigungshandler. Dies wird auf NULL festgelegt, wenn ein Fehler vorliegt. Der zurückgegebene Zeiger weist eine positive Verweisanzahl auf, und der Aufrufer muss IWbemServices::Release auf dem Zeiger aufrufen, wenn er nicht mehr benötigt wird. Ein NULL-Wert kann zurückgegeben werden, wenn kein Benachrichtigungshandler verfügbar ist. Dies ist kein Fehler.

Hinweis Der Wert des ppResponseHandler-Parameters kann nicht NULL sein, wenn er an diese Methode übergeben wird.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

COM-spezifische Fehlercodes können auch zurückgegeben werden, wenn Netzwerkprobleme dazu führen, dass die Remoteverbindung mit der Windows-Verwaltung verloren geht.

Hinweis Das Auslösen von Ereignissen mithilfe von QueryObjectSink ist standardmäßig nur für Administratoren zulässig. Um die Berechtigung auf andere Benutzer zu erweitern, muss ihnen WBEM_FULL_WRITE Berechtigung erteilt werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	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

Weitere Informationen

IWbemObjectSink

IWbemServices

Abfragen von WMI

Freigeben über