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

Article
08/27/2023

La méthode IWbemClassObject::Next récupère la propriété suivante dans une énumération qui a commencé par IWbemClassObject::BeginEnumeration. Cela doit être appelé à plusieurs reprises pour énumérer toutes les propriétés jusqu’à ce que WBEM_S_NO_MORE_DATA retourne. Si l’énumération doit être arrêtée tôt, IWbemClassObject::EndEnumeration doit être appelé.

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

Syntaxe

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

Paramètres

[in] lFlags

Réservé. Ce paramètre doit être 0.

[out] strName

Reçoit un nouveau BSTR qui contient le nom de la propriété. Pour éviter les fuites de mémoire dans le processus client, l’appelant doit appeler SysFreeString lorsque le nom n’est plus requis. Vous pouvez définir ce paramètre sur NULL si le nom n’est pas requis.

[out] pVal

Ce VARIANT est rempli avec la valeur de la propriété . La méthode appelle VariantInit sur ce VARIANT. L’appelant doit donc s’assurer que le VARIANT n’est pas actif avant l’appel. L’appelant doit utiliser VariantClear lorsque la valeur n’est plus requise.

Vous pouvez définir ce paramètre sur NULL si la valeur n’est pas requise. Si un code d’erreur est retourné, le VARIANT pointé par pVal n’est pas modifié.

[out, optional] pType

Ce paramètre peut être NULL. S’il n’est pas NULL, il doit pointer vers une variable CIMTYPE ( un LONG) dans laquelle le type de la propriété est placé. Il est possible que la valeur de cette propriété soit une VT_NULLVARIANT, auquel cas il est nécessaire de déterminer le type réel de la propriété.

[out, optional] plFlavor

Peut être NULL. Si elle n’est pas NULL, la valeur LONG pointée vers reçoit des informations sur l’origine de la propriété comme suit. Pour plus d’informations, consultez Saveurs de qualificateur et WBEM_FLAVOR_TYPE.

WBEM_FLAVOR_ORIGIN_SYSTEM

La propriété est une propriété système standard.

Pour les classes :

WBEM_FLAVOR_ORIGIN_PROPAGATED

La propriété a été héritée de la classe parente.

La propriété, bien qu’héritée de la classe parente, n’a pas été modifiée au niveau instance.

WBEM_FLAVOR_ORIGIN_LOCAL

La propriété appartient à la classe la plus dérivée.

La propriété est modifiée au niveau instance (autrement dit, une valeur a été fournie ou un qualificateur a été ajouté/modifié).

Pour les instances :

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique l’état de l’appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Remarques

Si le type sous-jacent de la propriété est un chemin d’objet, une date ou une heure ou un autre type spécial, le type retourné ne contient pas suffisamment d’informations. L’appelant doit examiner le CIMTYPE pour la propriété spécifiée et déterminer si la propriété est une référence d’objet, une date ou une heure ou un autre type spécial.

Cette méthode retourne également les propriétés système.

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 (inclure Wbemidl.h)
Bibliothèque	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll