Ereignis „ISWbemSinkEvents::OnObjectReady“

Das Ereignis OnObjectReady eines SWbemSink-Objekts wird ausgelöst, wenn ein asynchroner Vorgang ein Objekt zurückgibt. Verwenden Sie dieses Ereignis, um Objekte aus asynchronen Aufrufen wie SWbemObject.InstancesAsync_ oder SWbemServices.ExecQueryAsync zu verarbeiten. OnObjectReady gibt jedes Mal ein SWbemObject zurück, bis die Enumeration abgeschlossen ist.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripting-API.

Syntax

SWbemSink.OnObjectReady( _
  ByVal objWbemObject, _
  ByVal objWbemAsyncContext _
)

Parameter

objWbemObject

Ein SWbemObject-Objekt. Dies ähnelt dem, was vom synchronen Äquivalent des asynchronen Aufrufs zurückgegeben wird, der dieses Ereignis auslöst. Beispielsweise gibt ein Aufruf der SWbemServices.GetAsync-Methode ein SWbemObject im Parameter objWbemObject des Ereignisses OnObjectReady des SWbemSink-Objekts zurück, das als Parameter objWbemObject des ursprünglichen Aufrufs übergeben wird. Dasselbe SWbemObject-Objekt kann mithilfe eines entsprechenden synchronen Aufrufs von SWbemServices.Get abgerufen werden.

objWbemAsyncContext

Ein Objekt SWbemNamedValueSet, das an den ursprünglichen asynchronen Aufruf übergeben wird. Verwenden Sie diesen Parameter, um den Ursprung des asynchronen Aufrufs zu identifizieren, der dieses Ereignis auslöst, wenn mehrere asynchrone Aufrufe mit dieser Objektsenke ausgeführt werden.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Fehlercodes

Nach Abschluss des Ereignisses OnObjectReady kann das Err-Objekt einen der folgenden Fehlercodes enthalten.

wbemErrFailed - 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Es ist nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs vorhanden.

wbemErrTransportFailure – 2147749909 (0x80041015)

Netzwerkfehler, der den normalen Betrieb verhinderte.

Bemerkungen

Ein asynchroner Rückruf ermöglicht es nicht authentifizierten Benutzer*innen, Daten für die Senke bereitzustellen. Dies stellt Sicherheitsrisiken für Ihre Skripts und Anwendungen dar. Um die Risiken zu beseitigen, verwenden Sie entweder halbsynchrone Kommunikation oder synchrone Kommunikation. Weitere Informationen finden Sie unter Aufrufen einer Methode.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Header	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

Weitere Informationen

SWbemSink