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 |
|
| IDL |
|
| DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSink |