SWbemQualifierSet.Add-Methode

Die Add-Methode des SWbemQualifierSet-Objekts fügt der SWbemQualifierSet-Sammlung ein SWbemQualifier-Objekt hinzu. Ist in der Sammlung bereits ein Qualifizierer mit dem gleichen Namen vorhanden, wird er ersetzt.

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

Syntax

objQualifier = .Add( _
  ByVal strName, _
  ByVal varVal, _
  [ ByVal bPropagatesToSubclasses ], _
  [ ByVal bPropagatesToInstances ], _
  [ ByVal bOverridable ], _
  [ ByVal iFlags ] _
)

Parameter

strName [in]

Erforderlich. Der Name des neuen Qualifizierers.

varVal [in]

Erforderlich. Der Variantenwert des neuen Qualifizierers.

bPropagatesToSubclasses [in, optional]

Boolescher Wert, der angibt, ob dieser neue Qualifizierer an Unterklassen weitergegeben wird. Der Standardwert ist TRUE.

bPropagatesToInstances [in, optional]

Boolescher Wert, der angibt, ob dieser neue Qualifizierer an Instanzen weitergegeben wird. Der Standardwert ist TRUE.

bOverridable [in, optional]

Boolescher Wert, der angibt, ob dieser Qualifizierer bei der Weitergabe außer Kraft gesetzt werden kann. Der Standardwert ist TRUE.

iFlags [in, optional]

Reserviert. Der Standardwert ist 0.

Rückgabewert

Bei erfolgreicher Ausführung gibt die Methode ein SWbemQualifier-Objekt zurück, das den neuen Qualifizierer darstellt. Andernfalls wird ein NULL-Objekt zurückgegeben.

Fehlercodes

Nach Abschluss der Add-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste:

wbemErrInvalidParameter – 2147749896 (0x80041008)

Der iFlags-Parameter war ungültig.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrCannotBeKey – 2147749919 (0x8004101F)

Es wurde versucht, einen Qualifizierer vom Typ Schlüssel für eine Eigenschaft anzugeben, die kein Schlüssel sein kann. Dies ist nicht zulässig. Die Schlüssel sind in der Klassendefinition für ein Objekt angegeben und können nicht für jede Instanz einzeln geändert werden.

wbemErrInvalidQualifierType – 2147749929 (0x80041029)

Der Qualifizierertyp des varVal-Parameters ist unzulässig.

wbemErrOverrideNotAllowed – 2147749914 (0x8004101A)

Der SWbemQualifierSet.Add-Vorgang kann für diesen Qualifizierer nicht ausgeführt werden, da das besitzende Objekt keine Außerkraftsetzungen zulässt.

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_SWbemQualifierSet
IID	IID_ISWbemQualifierSet

Weitere Informationen

SWbemQualifierSet

SWbemQualifierSet.Remove