Next, fonction
Récupère la propriété suivante dans une énumération qui commence par un appel à 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 Next (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] BSTR* pstrName,
[out] VARIANT* pVal,
[out] CIMTYPE* pvtType,
[out] LONG* plFlavor
);
Paramètres
vFunc
[in] Ce paramètre est inutilisé.
ptr
[in] Pointeur vers une instance IWbemClassObject.
lFlags
[in] Réservée. Ce paramètre doit être 0.
pstrName
[out] Nouveau BSTR qui contient le nom de la propriété. Vous pouvez affecter à ce paramètre la valeur null si le nom n’est pas obligatoire.
pVal
[out] VARIANT rempli avec la valeur de la propriété. Vous pouvez affecter à ce paramètre la valeur null si la valeur n’est pas obligatoire. Si la fonction retourne un code d’erreur, le VARIANT passé à pVal n’est pas modifié.
pvtType
[out] Pointeur vers une variable CIMTYPE (LONG dans lequel le type de la propriété est placé). La valeur de cette propriété peut être VT_NULL_VARIANT. Dans ce cas, il est nécessaire de déterminer le type réel de la propriété. Ce paramètre peut également être null.
plFlavor
[out] null ou une valeur qui reçoit des informations sur l’origine de la propriété. Consultez la section [Remarques] pour connaître les valeurs possibles.
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_FAILED |
0x80041001 | Il y a eu une défaillance générale. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un paramètre n'est pas valide. |
WBEM_E_UNEXPECTED |
0x8004101d | Il n’y a pas eu d’appel à la fonction BeginEnumeration. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | La mémoire disponible est insuffisante pour commencer une nouvelle énumération. |
WBEM_E_TRANSPORT_FAILURE |
0x80041015 | Échec de l’appel de procédure distante entre le processus actuel et Windows Management Instrumentation. |
WBEM_S_NO_ERROR |
0 | L’appel de fonction a réussi. |
WBEM_S_NO_MORE_DATA |
0x40005 | Il n’y a plus de propriétés dans l’énumération. |
Notes
Cette fonction inclut dans un wrapper un appel à la méthode IWbemClassObject::Next.
Cette méthode retourne également les propriétés système.
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 de la propriété spécifiée pour déterminer si la propriété est une référence d’objet, une date ou une heure, ou un autre type spécial.
Si plFlavor n’est pas null, la valeur LONG reçoit les informations relatives à l’origine de la propriété, comme indiqué ci-dessous :
| Constant | Valeur | Description |
|---|---|---|
WBEM_FLAVOR_ORIGIN_SYSTEM |
0x40 | La propriété est une propriété système standard. |
WBEM_FLAVOR_ORIGIN_PROPAGATED |
0x20 | Pour une classe : la propriété est héritée de la classe parente. Pour une instance : la propriété, héritée de la classe parente, n’a pas été modifiée par l’instance. |
WBEM_FLAVOR_ORIGIN_LOCAL |
0 | Pour une classe : la propriété appartient à la classe dérivée. Pour une instance : la propriété est modifiée par l’instance. Autrement dit, une valeur a été fournie ou un qualificateur a été ajouté ou modifié. |
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : WMINet_Utils.idl
Versions de .NET Framework : disponibles depuis la version 4.7.2
