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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemPropertySet |
| IID |
IID_ISWbemPropertySet |