SWbemPropertySet.Remove-Methode

Die Remove-Methode des SWbemPropertySet-Objekts löscht eine Eigenschaft aus der SWbemPropertySet-Auflistung.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.

Syntax

SWbemPropertySet.Remove( _
  ByVal strName, _
  [ ByVal iFlags ] _
)

Parameter

strName [ In]

Erforderlich. Name des zu entfernenden Elements.

iFlags [ in, optional]

Reserviert. Dieser Wert muss 0 (null) sein, wenn angegeben.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Fehlercodes

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

wbemErrFailed – 2147749889 (0x80041001)

Nicht angegebener Fehler.

wbemErrInvalidOperation – 2147749910 (0x80041016)

Der Benutzer hat versucht, eine Eigenschaft zu löschen, die nicht gelöscht werden kann.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Ungültiger Parameter wurde angegeben.

wbemErrNotFound – 2147749890 (0x80041002)

Die angegebene Eigenschaft ist nicht vorhanden.

wbemErrOutOfMemory : 2147749894 (0x80041006)

Nicht genügend Arbeitsspeicher für die Ausführung dieser Methode.

wbemErrPropagatedProperty – 142927303552 (0x2147219380)

Der Benutzer hat versucht, eine Eigenschaft zu löschen, die nicht im Besitz von war. Die Eigenschaft wurde von einer übergeordneten Klasse vererbt.

wbemErrResetToDefault – 2147758082 (0x80043002)

Der Benutzer hat einen Außerkraftsetzungs-Standardwert für die aktuelle Klasse gelöscht. Der Standardwert für diese Eigenschaft in der übergeordneten Klasse wurde reaktiviert.

Hinweise

Eigenschaften können nicht aus Klasseninstanzen oder abgeleiteten Klassen mit geerbten Eigenschaften entfernt werden. Solche Löschversuche führen zu einem Fehler, und die Eigenschaft wird nicht entfernt. die -Eigenschaft auf ihren Standardwert zurückgesetzt wird.

Sie können beim Entfernen von Elementen keine Auflistung iterieren, da der Auflistungszeiger zum nächsten Element verschoben wird, wenn Sie ein Element aus einer Auflistung entfernen. Weitere Informationen finden Sie unter Zugreifen auf eine Auflistung.

Beispiele

Ein Codebeispiel, in dem diese Methode verwendet wird, finden Sie im Thema SWbemPropertySet.

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 _ SWbemPropertySet
IID
IID _ ISWbemPropertySet

Weitere Informationen

SWbemPropertySet

SWbemPropertySet.Add