IWbemQualifierSet ::P ut, méthode (wbemcli.h)

La méthode IWbemQualifierSet ::P ut écrit le qualificateur et la valeur nommés. Le nouveau qualificateur remplace la valeur précédente du même nom. Si le qualificateur n’existe pas, il est créé.

Parfois, il n’est pas possible d’écrire la valeur d’un qualificateur, par exemple, si le qualificateur est propagé à partir d’un autre objet. En règle générale, les qualificateurs propagés sont en lecture seule, mais ils peuvent être remplacés. Pour plus d’informations, consultez Saveurs des qualificateurs.

Lors de l’utilisation du qualificateur de clé, il n’est pas nécessaire de spécifier des saveurs ou des règles de propagation.

L’utilisateur ne peut pas créer de qualificateurs avec des noms qui commencent ou se terminent par un trait de soulignement (_). Cela est réservé aux classes et aux propriétés système.

Syntaxe

HRESULT Put(
  [in] LPCWSTR wszName,
  [in] VARIANT *pVal,
  [in] long    lFlavor
);

Paramètres

[in] wszName

Nom du qualificateur en cours d’écriture. Le pointeur est traité en lecture seule.

[in] pVal

Ne peut pas être NULL. Cela doit pointer vers un VARIANT valide qui contient la valeur de qualificateur à écrire. Le pointeur est traité en lecture seule. Il est de la responsabilité de l’appelant d’appeler VariantClear sur ce pointeur une fois que la valeur n’est pas requise.

Seules les variantes et tableaux de type VT_I4, VT_R8, VT_BSTRVT_BOOL sont pris en charge.

[in] lFlavor

Saveurs de qualificateur souhaitées pour ce qualificateur. La liste suivante répertorie les constantes appropriées pour lFlavor. La valeur par défaut est zéro (0).

WBEM_FLAVOR_OVERRIDABLE (0 (0x0))

La valeur qualificateur peut être remplacée dans une classe dérivée ou une instance. Il s’agit de la valeur par défaut. L’utilisation de cette constante est identique à l’utilisation de l’indicateur EnableOverride .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE (1 (0x1))

Le qualificateur est propagé aux instances. L’utilisation de cette constante est identique à l’utilisation de l’indicateur ToInstance .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS (2 (0x2))

Le qualificateur est propagé aux classes dérivées. L’utilisation de cette constante est identique à l’utilisation de l’indicateur ToSubClass .

WBEM_FLAVOR_NOT_OVERRIDABLE (16 (0x10))

La valeur qualificateur ne peut pas être remplacée dans une classe dérivée ou une instance. L’utilisation de cette constante est identique à l’utilisation de l’indicateur DisableOverride .

WBEM_FLAVOR_AMENDED (128 (0x80))

Le qualificateur est localisé. L’utilisation de cette constante est identique à l’utilisation de l’indicateur Modifié .

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique l’état de l’appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Configuration requise

Voir aussi

Types de qualificateurs