Partager via

QualifierSet_Next, fonction

  • Article

Récupère le qualificateur suivant dans une énumération commencée avec un appel à la fonction QualifierSet_BeginEnumeration.

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_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Paramètres

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

ptr [in] Pointeur vers une instance IWbemQualifierSet.

lFlags [in] Réservée. Ce paramètre doit être 0.

pstrName [out] Nom du qualificateur. Si null, ce paramètre est ignoré ; sinon, pstrName ne doit pas pointer vers un BSTR valide sous peine de provoquer une fuite de mémoire. Si la valeur n’est pas Null, la fonction allouera toujours un nouveau BSTR chaque fois qu’elle retournera WBEM_S_NO_ERROR.

pVal [out] En cas de réussite, valeur du qualificateur. Si la fonction échoue, le VARIANT pointé par pVal n’est pas modifié. Si ce paramètre est null, le paramètre est ignoré.

plFlavor [out] Pointeur vers un LONG qui reçoit la saveur de qualificateur. Si les informations de saveur ne sont pas souhaitées, ce paramètre peut être null.

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 Un paramètre n'est pas valide.
WBEM_E_UNEXPECTED 0x8004101d L’appelant n’a pas appelé QualifierSet_BeginEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 La mémoire disponible est insuffisante pour commencer une nouvelle énumération.
WBEM_S_NO_MORE_DATA 0x40005 Il ne reste plus aucun qualificateur dans l’énumération.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

Cette fonction wrappe un appel à la méthode IWbemQualifierSet::Next.

Vous appelez la fonction QualifierSet_Next à plusieurs reprises pour énumérer tous les qualificateurs jusqu’à ce que la fonction retourne WBEM_S_NO_MORE_DATA. Pour arrêter l’énumération au début, appelez la fonction QualifierSet_EndEnumeration.

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

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