Freigeben über


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