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 |
|
| IDL |
|
| DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSinkEvents |