Partager via

QualifierSet_Put, fonction

  • Article

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

Notes

Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le code du développeur.

Syntaxe

HRESULT QualifierSet_Put (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] VARIANT*             pVal,
   [in] LONG                 lFlavor
);

Paramètres

vFunc
[in] Ce paramètre est inutilisé.

ptr
[in] Pointeur vers une instance IWbemQualifierSet.

wszName
[in] Nom du qualificateur à écrire.

pVal
[in] Pointeur vers un VARIANT valide qui contient le qualificateur à écrire. Ce paramètre ne peut pas être null.

lFlavor
[in] Une des constantes suivantes qui définit les saveurs souhaitées pour ce qualificateur. La valeur par défaut est WBEM_FLAVOR_OVERRIDABLE (0).

Constant Valeur Description
WBEM_FLAVOR_OVERRIDABLE 0 Le qualificateur ne peut pas être substitué dans une classe dérivée ou une instance. Il s’agit de la valeur par défaut.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE 1 Le qualificateur est propagé aux instances.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS 2 Le qualificateur est propagé aux classes dérivées.
WBEM_FLAVOR_NOT_OVERRIDABLE 0x10 Le qualificateur ne peut pas être écrasé dans une classe ou une instance dérivée.
WBEM_FLAVOR_AMENDED 0x80 Le qualificateur est localisé.

Valeur retournée

Les valeurs suivantes renvoyées par cette fonction sont définies dans le fichier d’en-tête WbemCli.h, ou vous pouvez les définir comme constantes dans votre code :

Constant Valeur Description
WBEM_E_CANNOT_BE_KEY 0x8004101f Une tentative non conforme a été effectuée pour 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.
WBEM_E_INVALID_PARAMETER 0x80041008 Un paramètre n'est pas valide.
WBEM_E_INVALID_QUALIFIER_TYPE 0x80041029 Le paramètre pVal n’est pas d’un type de qualificateur conforme.
WBEM_E_OVERRIDE_NOT_ALLOWED 0x8004101a Il n’est pas possible d’appeler la méthode QualifierSet_Put dans le qualificateur, car l’objet propriétaire n’autorise pas les remplacements.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

Cette fonction wrappe un appel à la méthode IWbemQualifierSet::Put.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : WMINet_Utils.idl

Versions de .NET Framework : disponibles depuis la version 4.7.2

Voir aussi