SWbemQualifierSet.Add, méthode

Article
07/03/2023

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

Pour obtenir 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 [in]: Obligatoire. Nom du nouveau qualificateur.
varVal [entrée]: Obligatoire. Valeur variante du nouveau qualificateur.
bPropagatesToSubclasses [entrée, facultatif]: Valeur booléenne qui indique si ce nouveau qualificateur est propagé aux sous-classes. La valeur par défaut est TRUE.
bPropagatesToInstances [entrée, facultatif]: Valeur booléenne qui indique si ce nouveau qualificateur est propagé aux instances. La valeur par défaut est TRUE.
bOverridable [entrée, facultatif]: Valeur booléenne qui indique si ce qualificateur peut être remplacé lors de la propagation. La valeur par défaut est TRUE.
iFlags [entrée, facultatif]: Réservé. La valeur par défaut est 0.

Valeur retournée

Si elle réussit, cette méthode retourne un objet SWbemQualifier qui représente le nouveau qualificateur. Sinon, 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 de la liste suivante.

wbemErrInvalidParameter - 2147749896 (0x80041008): Le paramètre iFlags n’était pas valide.
wbemErrFailed - 2147749889 (0x80041001): Erreur non spécifiée.
wbemErrCannotBeKey - 2147749919 (0x8004101F): Une tentative non conforme a été effectuée pour spécifier un qualificateur Key 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 d’un type de qualificateur conforme.
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

Partager via