SWbemPropertySet.Remove method

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

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

Syntax

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

Parameter

strName [in]

Erforderlich. Name des zu entfernenden Elements.

iFlags [in, optional]

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

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Fehlercodes

Nach Abschluss der Methode Remove_ enthält das Objekt Err möglicherweise einen der Fehlercodes aus der folgenden Liste.

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)

Es wurde ein ungültiger Parameter 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)

Benutzer hat versucht, eine Eigenschaft ohne Besitzer zu löschen. Die Eigenschaft wurde von einer übergeordneten Klasse vererbt.

wbemErrResetToDefault - 2147758082 (0x80043002)

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

Bemerkungen

Eigenschaften können nicht aus Klasseninstanzen oder abgeleiteten Klassen mit geerbten Eigenschaften entfernt werden. Solche Löschversuche lösen einen Fehler aus, und die Eigenschaft wird nicht entfernt. Die Eigenschaft wird auf ihren Standardwert zurückgesetzt.

Sie können eine Sammlung beim Entfernen von Elementen nicht durchlaufen, da der Sammlungszeiger beim Entfernen eines Elements aus einer Sammlung auf das nächste Element verschoben wird. Weitere Informationen finden Sie unter Zugreifen auf eine Sammlung.

Beispiele

Ein Codebeispiel, das diese Methode verwendet, 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