fonction QualifierSet_Put

É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éé.

Note

Cette API est destinée uniquement à une utilisation interne. Il n’est pas destiné à être utilisé à partir du 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 n’est pas utilisé.

ptr
[in] Pointeur vers une instance IWbemQualifierSet .

wszName
[in] Nom du qualificateur à écrire.

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

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

Constante	Valeur	Descriptif
WBEM_FLAVOR_OVERRIDABLE	0	Le qualificateur peut être substitué dans une classe ou une instance dérivée. 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 substitué dans une classe ou une instance dérivée.
WBEM_FLAVOR_AMENDED	0x80	Le qualificateur est localisé.

Valeur retournée

Les valeurs suivantes retourné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 :

Constante	Valeur	Descriptif
WBEM_E_CANNOT_BE_KEY	0x8004101f	Il y a eu une tentative illégale de spécifier le Key qualificateur sur une propriété qui ne peut pas être une clé. Les clés sont spécifiées dans la définition de classe d’un objet et ne peuvent pas être modifiées par instance.
WBEM_E_INVALID_PARAMETER	0x80041008	Un paramètre n’est pas valide.
WBEM_E_INVALID_QUALIFIER_TYPE	0x80041029	Le pVal paramètre n’est pas d’un type de qualificateur juridique.
WBEM_E_OVERRIDE_NOT_ALLOWED	0x8004101a	Il n’est pas possible d’appeler la QualifierSet_Put méthode sur le qualificateur, car l’objet propriétaire n’autorise pas les remplacements.
WBEM_S_NO_ERROR	0	L’appel de fonction a réussi.

Remarques

Cette fonction encapsule un appel à la méthode IWbemQualifierSet ::P ut .

Spécifications

Plateformes : Consultez Configuration requise.

En-tête: WMINet_Utils.idl

Versions du .NET Framework : Disponible depuis la version 4.7.2

Voir aussi

• Compteurs de performances et WMI (informations de référence sur l’API non managée)