SWbemPropertySet.Add-Methode
Die Add-Methode des SWbemPropertySet-Objekts fügt der SWbemPropertySet-Auflistung ein SWbemProperty-Objekt hinzu. Wenn in der Auflistung bereits eine Eigenschaft mit demselben Namen vorhanden ist, wird ihr Inhalt durch die neue Definition ersetzt.
Hinweis
Der Wert der hinzugefügten Eigenschaft ist nach diesem Vorgang NULL (nicht zugewiesen). Um den Wert einer WMI-Eigenschaft festzulegen oder zu ändern, müssen Sie die Value-Eigenschaft des zurückgegebenen SWbemProperty-Objekts festlegen.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skript-API.
Syntax
objProperty = .Add( _
ByVal strName, _
ByVal iCIMType, _
[ ByVal bIsArray ], _
[ ByVal iFlags ] _
)
Parameter
-
strName [in]
-
Erforderlich. Der Name der neuen Eigenschaft.
-
iCIMType [in]
-
Erforderlich. Eine Ganzzahl, die den CIMType-Qualifizierer der neuen Eigenschaft repräsentiert. Unter WbemCimTypeEnum finden Sie eine Liste mit den CIMType-Qualifizierern und den zugehörigen Werten.
-
bIsArray [in, optional]
-
Gibt an, ob es sich bei der Eigenschaft um einen Arraytyp handelt. Der Standardwert für diesen Parameter ist FALSE.
-
iFlags [in, optional]
-
Ist reserviert und muss bei Angabe auf „0“ festgelegt werden.
Rückgabewert
Bei erfolgreicher Ausführung gibt diese Methode ein SWbemProperty-Objekt zurück, das die neue Eigenschaft repräsentiert. Andernfalls wird ein NULL-Objekt zurückgegeben.
Fehlercodes
Nach Abschluss der Add-Methode kann das Err-Objekt einen der folgenden Fehlercodes enthalten.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Unspezifizierter Fehler.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Es wurde ein ungültiger Parameter angegeben.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Nicht genügend Arbeitsspeicher für die Ausführung dieser Methode.
-
wbemErrInvalidPropertyType – 2147749930
-
Der CIMType-Qualifizierer wird nicht erkannt.
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 |