Partager via

QualifierSet_BeginEnumeration, fonction

  • Article

Réinitialise un énumérateur des qualificateurs d’un objet au début de l’énumération.

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_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Paramètres

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

ptr
[in] Pointeur vers une instance IWbemQualifierSet.

lFlags
[in] Combinaison de bits des indicateurs ou valeurs décrits dans la section Remarks qui spécifie les qualificateurs à inclure dans l’énumération.

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_INVALID_PARAMETER 0x80041008 Le paramètre lFlags n'est pas valide.
WBEM_E_UNEXPECTED 0x8004101d Un deuxième appel à QualifierSet_BeginEnumeration a été effectué sans appel intermédiaire à QualifierSet_EndEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 La mémoire disponible est insuffisante pour commencer une nouvelle énumération.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

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

Pour énumérer tous les qualificateurs sur un objet, cette méthode doit être appelée avant le premier appel à QualifierSet_Next. L’ordre d’énumération des qualificateurs est garanti comme invariant pour une énumération donnée.

Les indicateurs qui peuvent être passés en tant qu’argument lEnumFlags sont définis dans l’argument WbemCli.h, ou vous pouvez les définir en tant que constantes dans votre code.

Constant Valeur Description
0 Retourne le nom de tous les qualificateurs.
WBEM_FLAG_LOCAL_ONLY 0x10 Retourne uniquement les noms des qualificateurs propres à la propriété ou à l’objet actuel.
Pour une propriété : retourne uniquement les qualificateurs propres à la propriété (y compris les remplacements), et non les qualificateurs propagés à partir de la définition de classe.
Pour une instance : retourne uniquement des noms de qualificateurs propres à l’instance.
Pour une classe : retourne uniquement les qualificateurs propres à la classe dérivée.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Retourne uniquement les noms des qualificateurs propagés à partir d’un autre objet.
Pour une propriété : retourne uniquement les qualificateurs propagés vers cette propriété à partir de la définition de classe, et non ceux de la propriété même.
Pour une instance : retourne uniquement les qualificateurs propagés à partir de la définition de classe.
Pour une classe : retourne uniquement les noms de qualificateurs hérités des classes parentes.

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