SWbemQualifierSet. Add, méthode

La méthode Add de l’objet SWbemQualifierSet ajoute un objet SWbemQualifier à la collection SWbemQualifierSet . Si un qualificateur portant le même nom existe déjà dans la collection, il est remplacé.

Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.

Syntaxe

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

Paramètres

strName [ dans]

Obligatoire. Nom du nouveau qualificateur.

varVal [ dans]

Obligatoire. Valeur de type Variant du nouveau qualificateur.

bPropagatesToSubclasses [ dans, facultatif]

Valeur booléenne qui indique si ce nouveau qualificateur est propagé aux sous-classes. La valeur par défaut est true.

bPropagatesToInstances [ dans, facultatif]

Valeur booléenne qui indique si ce nouveau qualificateur est propagé aux instances. La valeur par défaut est true.

bOverridable [ dans, facultatif]

Valeur booléenne qui indique si ce qualificateur peut être substitué lorsqu’il est propagé. La valeur par défaut est true.

IFlags [ dans, facultatif]

Réservé. La valeur par défaut est 0.

Valeur de retour

En cas de réussite, cette méthode retourne un objet SWbemQualifier qui représente le nouveau qualificateur. Dans le cas contraire, un objet null est retourné.

Codes d’erreur

Une fois la méthode Add terminée, l’objet Err peut contenir l’un des codes d’erreur répertoriés dans la liste suivante.

wbemErrInvalidParameter -2147749896 (0x80041008)

Le paramètre IFlags n’est pas valide.

wbemErrFailed -2147749889 (0x80041001)

Erreur non spécifiée.

wbemErrCannotBeKey -2147749919 (0x8004101F)

Tentative non autorisée de spécifier un qualificateur de clé sur une propriété qui ne peut pas être une clé. Les clés sont spécifiées dans la définition de classe pour un objet et ne peuvent pas être modifiées au niveau de l'instance.

wbemErrInvalidQualifierType -2147749929 (0x80041029)

Le paramètre varVal n’est pas un type de qualificateur légal.

wbemErrOverrideNotAllowed -2147749914 (0x8004101A)

Il n’est pas possible d’effectuer l’opération SWbemQualifierSet. Add sur ce qualificateur, car l’objet propriétaire n’autorise pas les remplacements.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
Wbemdisp. h
Bibliothèque de types
Wbemdisp. tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemQualifierSet
IID
IID _ ISWbemQualifierSet

Voir aussi

SWbemQualifierSet

SWbemQualifierSet. Remove