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
Wbemdisp.h
Idl
Wbemdisp.idl
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemSink
IID
IID _ ISWbemSinkEvents