Méthode IWbemQualifierSet ::BeginEnumeration (wbemcli.h)

La méthode IWbemQualifierSet ::BeginEnumeration est réinitialisée avant qu’il n’y ait une énumération de tous les qualificateurs dans l’objet. Pour énumérer tous les qualificateurs d’un objet, cette méthode doit être appelée avant le premier appel à IWbemQualifierSet ::Next. L’ordre dans lequel les qualificateurs sont énumérés est garanti comme étant invariant pour un instance donné d’IWbemQualifierSet.

Syntaxe

HRESULT BeginEnumeration(
  [in] long lFlags
);

Paramètres

[in] lFlags

Spécifie les qualificateurs à inclure dans l’énumération. Il doit s’agir de l’une des constantes suivantes.

0 (zéro)

Retourne le nom de tous les qualificateurs.

WBEM_FLAG_LOCAL_ONLY

Retourne uniquement les noms des qualificateurs propres à la propriété ou à l’objet actuel. Si le jeu de qualificateurs en cours fait référence à une propriété, retourne uniquement les qualificateurs spécifiques à la propriété (y compris les remplacements), et non les qualificateurs propagés à partir de la définition de classe. Si le jeu de qualificateurs actuel fait référence à un instance, retournez uniquement les noms de qualificateurs spécifiques à instance. Si le jeu de qualificateurs actuel fait référence à une classe, retourne uniquement les qualificateurs spécifiques à la classe dérivée.

WBEM_FLAG_PROPAGATED_ONLY

Retourne uniquement les noms des qualificateurs propagés à partir d’un autre objet. Par exemple, si le jeu de qualificateurs actuel fait référence à une propriété, retournez uniquement les qualificateurs propagés à cette propriété à partir de la définition de classe, et non ceux de la propriété elle-même. Si le jeu de qualificateurs actuel fait référence à un instance, retournez uniquement les qualificateurs propagés à partir de la définition de classe. Si le jeu de qualificateurs actuel fait référence à une classe, retournez uniquement les noms de qualificateurs hérités des classes parentes.

Valeur retournée

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

Configuration requise

Voir aussi

IWbemQualifierSet

IWbemQualifierSet ::Next