Méthode IEnumContextProps ::Next (objidl.h)

Article
02/29/2024

Récupère le nombre spécifié d’éléments dans la séquence d’énumération.

Syntaxe

HRESULT Next(
  [in]  ULONG           celt,
  [out] ContextProperty *pContextProperties,
  [out] ULONG           *pceltFetched
);

Paramètres

[in] celt

Nombre d’éléments à récupérer. S’il reste moins que le nombre d’éléments demandé dans la séquence, cette méthode récupère les éléments restants.

[out] pContextProperties

Tableau d’éléments énumérés.

L’énumérateur est responsable de l’allocation de la mémoire et l’appelant est chargé de la libérer. Si celt est supérieur à 1, l’appelant doit également passer un pointeur non NULL passé à pceltFetched pour connaître le nombre de pointeurs à libérer.

[out] pceltFetched

Nombre d’éléments récupérés. Ce paramètre est toujours inférieur ou égal au nombre d’éléments demandés.

Valeur retournée

Si la méthode récupère le nombre d’éléments demandés, la valeur de retour est S_OK. Sinon, c’est S_FALSE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	objidl.h (inclure ObjIdl.h)

Voir aussi

IEnumContextProps

Partager via