Partager via

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

  • Last updated on