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

La méthode IWbemQualifierSet ::Next récupère le qualificateur suivant dans une énumération qui a commencé par IWbemQualifierSet ::BeginEnumeration. Cette méthode est appelée à plusieurs reprises pour énumérer tous les qualificateurs jusqu’à ce que WBEM_S_NO_MORE_DATA retourne. Pour terminer l’énumération tôt, appelez IWbemQualifierSet ::EndEnumeration.

L’ordre des qualificateurs retournés pendant l’énumération n’est pas défini.

Syntaxe

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pVal,
  [out] long    *plFlavor
);

Paramètres

[in] lFlags

Réservé. Ce paramètre doit être égal à 0 (zéro).

[out] pstrName

Ce paramètre reçoit le nom du qualificateur. Un nouveau BSTR est toujours alloué chaque fois que WBEM_S_NO_ERROR retourne.

Si pstrName a la valeur NULL, il est ignoré ; sinon, l’appelant doit s’assurer que ce paramètre ne pointe pas vers un BSTR valide lors de l’entrée, sinon il y aura une fuite de mémoire. En outre, l’appelant doit se rappeler d’appeler SysFreeString sur la chaîne retournée quand elle n’est plus nécessaire.

[out] pVal

Ce paramètre reçoit la valeur du qualificateur. VariantInit est appelé sur le VARIANT par cette méthode. L’appelant doit appeler VariantClear sur ce pointeur lorsque la valeur n’est plus requise. Si un code d’erreur est retourné, le VARIANT pointé par pVal n’est pas modifié. Ce paramètre est ignoré s’il est défini sur NULL.

[out] plFlavor

Si elle n’est pas NULL, la valeur pointée vers est définie sur la saveur de qualificateur. Pour plus d’informations, consultez Saveurs de qualificateur et WBEM_FLAVOR_TYPE.

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 ::BeginEnumeration

IWbemQualifierSet ::EndEnumeration

Types de qualificateurs