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	Wbemdisp.h
Typbibliothek	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPropertySet
IID	IID_ISWbemPropertySet

Weitere Informationen

SWbemPropertySet

SWbemPropertySet.Remove

SWbemProperty.Value