IWbemClassObject::D elete-Methode (wbemcli.h)

Die IWbemClassObject::D elete-Methode löscht die angegebene Eigenschaft aus einer CIM-Klassendefinition und allen zugehörigen Qualifizierern. Da Instanzen keine Inhalte aufweisen können, die sich von der besitzenden Klasse unterscheiden, sind Löschvorgänge für Eigenschaften nur für Klassendefinitionen möglich. Wenn Sie Delete für eine Eigenschaft in einer instance aufrufen, ist der Vorgang erfolgreich. Anstatt den Wert zu entfernen, wird er jedoch einfach auf den Standardwert für die Klasse zurückgesetzt.

Es ist nicht möglich, eine von einer übergeordneten Klasse geerbte Eigenschaft zu löschen. Wenn jedoch ein Überschreiben des Standardwerts für eine eigenschaft angegeben wurde, die von einer übergeordneten Klasse geerbt wurde, ist es möglich, durch Aufrufen dieser Methode auf den Standardwert des übergeordneten Elements zu rückgängig machen. In diesem Fall wird WBEM_S_RESET_TO_DEFAULT zurückgegeben.

Systemeigenschaften können nicht gelöscht werden.

Syntax

HRESULT Delete(
  [in] LPCWSTR wszName
);

Parameter

[in] wszName

Zu löschende Eigenschaftsname. Dies muss auf einen gültigen LPCWSTR verweisen. Sie wird als schreibgeschützt behandelt.

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. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

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 CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Weitere Informationen

IWbemClassObject

WMI-Systemeigenschaften