ISWbemSink::Cancel-Methode

Die Cancel-Methode des SWbemSink-Objekts bricht alle ausstehenden asynchronen Vorgänge ab, die dieser Objektsenke zugeordnet sind.

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

Syntax

SWbemSink.Cancel()

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Fehlercodes

Nach Abschluss der Cancel-Methode 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.

wbemErrAccessDenied – 2147749891 (0x80041003)

Der aktuelle oder angegebene Benutzername und das Kennwort sind nicht gültig oder für die Herstellung der Verbindung autorisiert.

Bemerkungen

Sie können nicht nur einen asynchronen Aufruf abbrechen. Wenn mehrere asynchrone Aufrufe ausstehen, die diese Objektsenke verwenden, bricht diese Methode alle asynchronen Aufrufe mit dieser Objektsenke ab. Asynchrone Aufrufe, die anderen Objektsenken zugeordnet sind, bleiben davon unberührt.

Sie können diese Senke nicht Nothing zuweisen, um einen asynchronen Vorgang abzubrechen. Sie müssen die Cancel-Methode aufrufen, damit WMI den Vorgang abbricht und die zugeordneten Ressourcen freigibt. Dies ist besonders wichtig bei langwierigen asynchronen Vorgängen (z. B. Abfragen) oder bei Vorgängen, die nie abgeschlossen werden (z. B. ExecNotificationQueryAsync).

Hinweis

Ein asynchroner Rückruf ermöglicht es einem nicht authentifizierten Benutzer, 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.

Im folgenden Beispiel wird gezeigt, wie Sie einen asynchronen Aufruf abbrechen.

objwbemsink.Cancel()
set objwbemsink= Nothing

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_ISWbemSink

Weitere Informationen

SWbemSink