IWbemContext::Next, méthode (wbemcli.h)

Article
08/27/2023

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 .

Note À la fin de l’énumération, WBEM_S_NO_MORE_DATA est retourné. Le VARIANT retourné est de type VT_NULL et le pstrName retourné est NULL.

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

Voir aussi

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::EndEnumeration

Share via