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

Artikel
08/27/2023

Die IWbemServices::D eleteClass-Methode löscht die angegebene Klasse aus dem aktuellen Namespace. Wenn der Klasse ein dynamischer instance Anbieter zugeordnet ist, wird die Registrierung des Anbieters aufgehoben und von dieser Klasse nicht mehr aufgerufen. Alle Klassen, die von der gelöschten Klasse abgeleitet sind, 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 ein dynamischer Klassenanbieter die Klasse bereitstellt, hängt der Erfolg des Löschvorgangs davon ab, ob der Anbieter das Löschen von Klassen unterstützt.

Hinweis Systemklassen können nicht gelöscht werden.

Syntax

HRESULT DeleteClass(
  [in]  const BSTR      strClass,
  [in]  long            lFlags,
  [in]  IWbemContext    *pCtx,
  [out] IWbemCallResult **ppCallResult
);

Parameter

[in] strClass

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

[in] lFlags

Einer der folgenden Werte kann festgelegt werden.

WBEM_FLAG_RETURN_IMMEDIATELY

Dieses Flag bewirkt, dass es sich um einen semisynchronen Aufruf handelt. Weitere Informationen finden Sie unter Aufrufen einer Methode.

WBEM_FLAG_OWNER_UPDATE

Gibt an, dass der Aufrufer ein Pushanbieter ist.

[in] pCtx

In der Regel 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 Ausführen von Aufrufen an WMI.

[out] ppCallResult

Wenn NULL, wird dieser Parameter nicht verwendet. Wenn ppCallResult angegeben ist, muss es beim Eintrag auf NULL zeigen. Wenn der lFlags-ParameterWBEM_FLAG_RETURN_IMMEDIATELY enthält, wird dieser Aufruf sofort mit WBEM_S_NO_ERROR zurückgegeben. Der ppCallResult-Parameter empfängt einen Zeiger auf ein neues IWbemCallResult-Objekt , das dann abgefragt werden kann, um das Ergebnis mithilfe der GetCallStatus-Methode abzurufen.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Bei einem Fehler können Sie alle verfügbaren Informationen über die COM-Funktion GetErrorInfo abrufen.

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

Anforderungen

Anforderung	Wert
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 eleteClassAsync

Abrufen eines Fehlercodes

Freigeben über