SWbemServices.DeleteAsync method
Die Methode DeleteAsync des Objekts SWbemServices löscht die im Objektpfad angegebene Klasse oder Instanz. Der Aufruf der Methode DeleteAsync gibt sofort eine Antwort zurück, und die Ergebnisse und Status werden an die aufrufende Funktion durch Ereignisse zurückgegeben, die an die Senke übermittelt werden, die in objWbemSink angegeben ist. Weitere Informationen zum Erstellen einer Senke finden Sie unter Empfangen eines WMI-Ereignisses. Sie können nur Objekte im Namespace löschen, mit dem Sie verbunden sind.
Wenn ein dynamischer Anbieter die Klasse oder Instanz bereitstellt, kann es möglich sein, dass Sie dieses Objekt nur löschen können, wenn der Anbieter das Löschen von Klassen oder Instanzen unterstützt.
Die Methode wird im asynchronen Modus aufgerufen. Weitere Informationen finden Sie unter Aufrufen einer Methode.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skript-API.
Syntax
SWbemServices.DeleteAsync( _
[ ByVal ObjWbemSink ], _
ByVal strObjectPath, _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Parameter
-
ObjWbemSink [optional]
-
Objektsenke, die die Ergebnisse des Löschvorgangs empfängt. Erstellen Sie ein SWbemSink-Objekt, um die Objekte zu empfangen.
-
strObjectPath
-
Erforderlich. Eine Zeichenfolge, die den Objektpfad zu dem Objekt enthält, das Sie löschen möchten. Weitere Informationen finden Sie unter Beschreiben des Speicherorts eines WMI-Objekts.
-
iFlags [optional]
-
Bestimmt, ob Statusaktualisierungen zurückgegeben werden. Dieser Parameter kann die folgenden Werte akzeptieren.
-
wbemFlagSendStatus (128 (0x80))
-
Bewirkt, dass asynchrone Aufrufe Statusupdates an den OnProgress-Ereignishandler für die Objektsenke senden.
-
wbemFlagDontSendStatus (0 (0x0))
-
Verhindert, dass asynchrone Aufrufe Statusupdates an den OnProgress-Ereignishandler für die Objektsenke senden.
objWbemNamedValueSet [optional]
Dies ist in der Regel nicht definiert. Andernfalls handelt es sich um ein SWbemNamedValueSet-Objekt, dessen Elemente die Kontextinformationen darstellen, die von dem Anbieter verwendet werden können, der die Anforderung verarbeitet. Ein Anbieter, der solche Informationen unterstützt oder benötigt, muss die erkannten Wertnamen, den Datentyp des Werts, die zulässigen Werte und die Semantik dokumentieren.
objWbemAsyncContext [optional]
Ein SWbemNamedValueSet-Objekt, das an die Objektsenke zurückgegeben wird, um die Quelle des ursprünglichen asynchronen Aufrufs zu identifizieren. Verwenden Sie diesen Parameter, wenn Sie mehrere asynchrone Aufrufe mit derselben Objektsenke ausführen. Zur Verwendung dieses Parameters erstellen Sie ein SWbemNamedValueSet-Objekt und verwenden die SWbemNamedValueSet.Add-Methode, um einen Wert hinzuzufügen, der den asynchronen Aufruf identifiziert, den Sie ausführen. Dieses SWbemNamedValueSet-Objekt wird an die Objektsenke zurückgegeben, und die Quelle des Aufrufs kann mithilfe der SWbemNamedValueSet.Item-Methode extrahiert werden. Weitere Informationen finden Sie unter Aufrufen einer Methode.
Rückgabewert
Diese Methode gibt keinen Wert zurück. Wenn der Aufruf erfolgreich ist, erhält die Objektsenke eine Benachrichtigung über den Löschvorgang.
Fehlercodes
Nach Abschluss der Methode DeleteAsync enthält das Objekt Err möglicherweise einen der Fehlercodes aus der folgenden Liste.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Unbekannter Fehler.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Es wurde ein ungültiger Parameter angegeben.
-
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.
-
wbemErrNotFound – 2147749890 (0x80041002)
-
Das angeforderte Element wurde nicht gefunden.
Bemerkungen
Dieser Aufruf gibt sofort eine Antwort zurück. Der Status des Löschvorgangs wird durch einen Rückruf an die Senke zurückgegeben, die in objWbemSink angegeben ist. Sie können die endgültige Verarbeitung in Ihrer Implementierung des Ereignisses objWbemSink.OnCompleted durchführen.
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. Informationen zur Beseitigung der Risiken finden Sie unter Festlegen der Sicherheit für einen asynchronen Aufruf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |