IWbemServices::D eleteClassAsync-Methode (wbemcli.h)
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.
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 |