IWbemServices::D eleteClassAsync-Methode (wbemcli.h)

Artikel
08/27/2023

Die IWbemServices::D eleteClassAsync-Methode löscht die angegebene Klasse aus dem aktuellen Namespace. Diese Methode ist mit IWbemServices::D eleteClass identisch, mit der Ausnahme, dass der Aufruf sofort zurückgegeben wird. Bestätigung oder Fehler werden asynchron an die angegebene Objektsenke mit der IWbemObjectSink::SetStatus-Methode gemeldet, nachdem der Vorgang abgeschlossen ist.

Syntax

HRESULT DeleteClassAsync(
  [in] const BSTR      strClass,
  [in] long            lFlags,
  [in] IWbemContext    *pCtx,
  [in] IWbemObjectSink *pResponseHandler
);

Parameter

[in] strClass

Name der Klasse, die zum Löschen vorgesehen ist.

[in] lFlags

Mindestens einer der folgenden Werte ist gültig.

WBEM_FLAG_SEND_STATUS

Dieses Flag registriert bei der Windows-Verwaltung eine Anforderung zum Empfangen von zwischengeschalteten status Berichten über die Clientimplementierung von IWbemObjectSink::SetStatus. Die Anbieterimplementierung muss die Berichterstellung zwischen status unterstützen, damit dieses Flag das Verhalten ändern kann.

WBEM_FLAG_OWNER_UPDATE

Pushanbieter müssen dieses Flag beim Aufrufen von DeleteClassAsync angeben, um anzugeben, dass diese Klasse geändert wurde.

[in] pCtx

Normalerweise NULL. Andernfalls ist dies ein Zeiger auf ein IWbemContext-Objekt , das vom Anbieter verwendet werden kann, der die Klasse löscht. Die Werte im Kontextobjekt müssen in der Dokumentation für den betreffenden Anbieter angegeben werden. Weitere Informationen zu diesem Parameter finden Sie unter Tätigen von Aufrufen von WMI.

[in] pResponseHandler

Zeiger auf eine Vom Aufrufer implementierte Implementierung von IWbemObjectSink . Dieser Handler empfängt die status der Löschanforderung, wenn sie über die IWbemObjectSink::SetStatus-Methode verfügbar wird. Wenn Fehlercode zurückgegeben wird, wird der angegebene IWbemObjectSink-Zeiger nicht verwendet. Wenn WBEM_S_NO_ERROR zurückgegeben wird, wird die IWbemObjectSink-Implementierung des Benutzers aufgerufen, um das Ergebnis des Vorgangs anzugeben. Die Windows-Verwaltung ruft AddRef nur auf dem Zeiger auf, wenn WBEM_S_NO_ERROR zurückgegeben wird. In Fällen, in denen ein Fehlercode zurückgegeben wird, ist die Verweisanzahl identisch mit der beim Eintrag. Eine ausführliche Erläuterung zu diesem Parameter finden Sie unter Aufrufen einer Methode.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

Alle anderen Rückgabecodes werden der Objektsenke bereitgestellt, die vom pReponseHandler-Parameter über die SetStatus-Methode angegeben wird. Fehlerbedingungen, z. B. wenn die Klasse nicht vorhanden ist oder der Benutzer nicht über die Berechtigung zum Löschen von Klassen verfügt, werden an den Handler gemeldet. Sie werden im Rückgabecode dieser Methode nicht gemeldet.

COM-spezifische Fehlercodes können auch zurückgegeben werden, wenn Netzwerkprobleme dazu führen, dass die Remoteverbindung mit der Windows-Verwaltung verloren geht.

Hinweise

Wenn der Klasse ein dynamischer instance Anbieter zugeordnet ist, wird der Anbieter nicht mehr registriert und für diese Klasse nicht mehr aufgerufen. Alle Klassen, die von der gelöschten Klasse abgeleitet werden, werden ebenfalls gelöscht, und die zugehörigen Anbieter werden nicht registriert. Alle ausstehenden statischen Instanzen der angegebenen Klasse und ihrer Unterklassen werden ebenfalls gelöscht, wenn die Klasse gelöscht wird.

Wenn die Klasse von einem dynamischen Klassenanbieter bereitgestellt wird, hängt der Erfolg des Löschvorgangs davon ab, ob das Löschen von Klassen von diesem Anbieter unterstützt wird.

Hinweis Standardsystemklassen können nicht gelöscht werden.

Da der Rückruf möglicherweise nicht auf der gleichen Authentifizierungsebene zurückgegeben wird, die der Client benötigt, wird empfohlen, die semisynchrone Kommunikation anstelle der asynchronen Kommunikation zu verwenden. Wenn Sie eine asynchrone Kommunikation benötigen, finden Sie weitere Informationen unter Aufrufen einer Methode.

Weitere Informationen zur semisynchronen Verwendung von Methoden finden Sie unter IWbemServices::D eleteClass und Aufrufen einer Methode.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

Weitere Informationen

IWbemServices

IWbemServices::D eleteClass

Abrufen eines Fehlercodes