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 |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID _ SWbemQualifierSet |
| IID |
IID _ ISWbemQualifierSet |