IWbemContext::Next, méthode (wbemcli.h)
La méthode IWbemContext::Next récupère la valeur suivante dans une énumération de toutes les valeurs de contexte commençant par IWbemContext::BeginEnumeration.
Syntaxe
HRESULT Next(
[in] long lFlags,
[out] BSTR *pstrName,
[out] VARIANT *pValue
);
Paramètres
[in] lFlags
Réservé. Ce paramètre doit être 0.
[out] pstrName
Ce paramètre ne peut pas être NULL. Le pointeur ne doit pas pointer vers un BSTR actif lors de l’entrée et, dans l’idéal, il doit être défini sur NULL. Si aucun code d’erreur n’est retourné, il est défini pour pointer vers un BSTR nouvellement alloué contenant le nom de la valeur de contexte.
L’appelant doit appeler SysFreeString sur la chaîne retournée quand elle n’est plus nécessaire. Si WBEM_S_NO_MORE_DATA retourne, pstrName est défini pour pointer sur NULL, auquel cas SysFreeString ne doit pas être appelé. Notez que si pstrName pointe vers un BSTR valide lors de l’entrée, ce BSTR n’est pas libéré et une fuite de mémoire se produit.
[out] pValue
Ce paramètre ne peut pas être NULL et doit pointer vers un VARIANT vide ou non initialisé. Si aucune erreur n’est retournée, le VARIANT est initialisé à l’aide de VariantInit, puis défini sur contenir la valeur de contexte. L’appelant doit appeler VariantClear sur ce pointeur lorsque la valeur n’est plus nécessaire. Si un code d’erreur est retourné, le VARIANT pointé par pValue n’est pas modifié.
Si WBEM_S_NO_MORE_DATA retourne, ce paramètre est défini pour pointer vers un VARIANT de type VT_NULL.
Il est possible qu’un objet IWbemClassObject entier soit retourné à l’intérieur du VARIANT. Si tel est le cas, VT_UNKNOWN est le type VARIANT . L’appelant peut prendre le pointeur IUnknown et exécuter QueryInterface pour obtenir le pointeur IWbemClassObject .
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
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | wbemcli.h (include Wbemidl.h) |
| Bibliothèque | Wbemuuid.lib |
| DLL | Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll |