ISWbemSinkEvents::OnCompleted-Ereignis

Artikel
07/03/2023

Das OnCompleted-Ereignis eines SWbemSink-Objekts wird ausgelöst, wenn ein asynchroner Aufruf abgeschlossen ist. Dieses Ereignis teilt der Clientanwendung das Ergebnis eines asynchronen Vorgangs mit und stellt Fehlerinformationen bereit, 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: HRESULT der abgeschlossenen asynchronen Methode. HRESULT ist mit dem Wert identisch, der von einem entsprechenden Methodenaufruf der COM-API für WMI zurückgegeben wird. Überprüfen Sie diesen Wert, um zu ermitteln, 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 mit 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): 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 vermeiden, verwenden Sie 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

Freigeben über