SWbemServices.DeleteAsync-Methode

Die DeleteAsync-Methode des SWbemServices-Objekts löscht die im Objektpfad angegebene Klasse oder Instanz. Der Aufruf von DeleteAsync wird sofort zurückgegeben, und die Ergebnisse und der Status werden an den Aufrufer über Ereignisse zurückgegeben, die an die in objWbemSink angegebene Senke übermittelt werden. Weitere Informationen zum Erstellen einer Senke finden Sie unter Empfangen eines WMI-Ereignisses. Sie können nur Objekte in dem Namespace löschen, mit dem Sie verbunden sind.

Wenn ein dynamischer Anbieter die Klasse oder Instanz liefert, ist es manchmal nicht möglich, dieses Objekt zu löschen, es sei denn, der Anbieter unterstützt das Löschen von Klassen oder Instanzen.

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 Skripterstellungs-API.

Syntax

SWbemServices.DeleteAsync( _
  [ ByVal ObjWbemSink ], _
  ByVal strObjectPath, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parameter

ObjWbemSink [ Optional]

Objektsenke, die die Ergebnisse des Löschvorgang 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 Statusupdates 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]

In der Regel ist dies nicht definiert. Andernfalls ist dies ein SWbemNamedValueSet-Objekt, dessen Elemente die Kontextinformationen darstellen, die vom Anbieter verwendet werden können, der die Anforderung bedient. Ein Anbieter, der solche Informationen unterstützt oder erfordert, muss die erkannten Wertnamen, den Datentyp des Werts, die zulässigen Werte und die Semantik dokumentieren.

objWbemAsyncContext [ Optional]

Ein SWbemNamedValueSet-Objekt, das zur Objektsenke zurückkehrt, um die Quelle des ursprünglichen asynchronen Aufrufs zu identifizieren. Verwenden Sie diesen Parameter, wenn Sie mehrere asynchrone Aufrufe mit derselben Objektsenke ausführen. Um diesen Parameter zu verwenden, erstellen Sie ein SWbemNamedValueSet-Objekt, und verwenden Sie die SWbemNamedValueSet.Add-Methode, um einen Wert hinzuzufügen, der den von Ihnen ausgeführten asynchronen Aufruf identifiziert. 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, empfängt die Objektsenke eine Benachrichtigung über den Löschvorgang.

Fehlercodes

Nach Abschluss der DeleteAsync-Methode kann das Err-Objekt einen der Fehlercodes in der folgenden Liste enthalten.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Ungültiger Parameter wurde angegeben.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs.

wbemErrTransportFailure – 2147749909 (0x80041015)

Netzwerkfehler, der den normalen Betrieb verhindert.

wbemErrAccessDenied – 2147749891 (0x80041003)

Der aktuelle oder angegebene Benutzername und das Kennwort sind nicht gültig oder autorisiert, um die Verbindung herzustellen.

wbemErrNotFound – 2147749890 (0x80041002)

Das angeforderte Element wurde nicht gefunden.

Hinweise

Dieser Aufruf wird sofort zurückgegeben. Der Status des Löschvorgang wird an den Aufrufer über einen Rückruf zurückgegeben, der an die in objWbemSink angegebene Senke übermittelt wird. Sie können die endgültige Verarbeitung in Ihrer Implementierung von objWbemSink ausführen. OnCompleted-Ereignis.

Ein asynchroner Rückruf ermöglicht es einem nicht authentifizierten Benutzer, Daten für die Senke zur Verfügung zu stellen. Dies birgt Sicherheitsrisiken für Ihre Skripts und Anwendungen. Informationen zum Beseitigen 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
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemServices
IID
IID _ ISWbemServices

Weitere Informationen

Swbemservices

SWbemObjectPath