ISWbemSinkEvents::OnCompleted-Ereignis
Das OnCompleted-Ereignis eines SWbemSink-Objekts wird ausgelöst, wenn ein asynchroner Aufruf abgeschlossen ist. Dieses Ereignis gibt für die Clientanwendung das Ergebnis eines asynchronen Vorgangs an und stellt Fehlerinformationen zur Verfügung, wenn der asynchrone Aufruf fehlschlägt.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.
Syntax
SWbemSink.OnCompleted( _
ByVal iHResult, _
ByVal objWbemErrorObject, _
ByVal objWbemAsyncContext _
)
Parameter
-
iHResult
-
Das HRESULT der abgeschlossenen asynchronen Methode. Das HRESULT entspricht dem Wert, der von einem entsprechenden COM-API für den WMI-Methodenaufruf zurückgegeben wird. Überprüfen Sie diesen Wert, um zu bestimmen, ob der asynchrone Aufruf erfolgreich ist. Wenn der asynchrone Aufruf erfolgreich ist, enthält dieser Parameter WBEM _ S _ NO ERROR _ (0). Wenn der asynchrone Aufruf fehlschlägt, enthält dieser Parameter einen Fehlercode.
-
objWbemErrorObject
-
Enthält ein SWbemLastError-Objekt, wenn die asynchrone Methode fehlschlägt.
-
objWbemAsyncContext
-
Dies ist ein SWbemNamedValueSet-Objekt, 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 mithilfe dieser Objektsenke ausgeführt werden.
Rückgabewert
Dieses Ereignis gibt keinen Wert zurück.
Fehlercodes
Nach Abschluss des OnCompleted-Ereignisses kann das Err-Objekt einen der folgenden Fehlercodes enthalten.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Unbekannter Fehler.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs.
-
wbemErrTransportFailure – 2147749909 (0x80041015)
-
Netzwerkfehler, der den normalen Betrieb verhindert.
Hinweise
Ein asynchroner Rückruf ermöglicht es einem nicht authentifizierten Benutzer, Daten für die Senke zur Verfügung zu stellen. Dies birgt Sicherheitsrisiken für Ihre Skripts und Anwendungen. Um die Risiken zu beseitigen, verwenden Sie die semisynchrone 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 |