Partager via


IEnumMoniker ::Next, méthode (objidl.h)

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

Syntaxe

HRESULT Next(
  [in]      ULONG    celt,
  [out]     IMoniker **rgelt,
  [in, out] ULONG    *pceltFetched
);

Paramètres

[in] celt

Nombre d’éléments à récupérer. Si le nombre d’éléments restant dans la séquence est inférieur au nombre demandé, cette méthode récupère les éléments restants.

[out] rgelt

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

L’énumérateur est chargé d’appeler AddRef, et l’appelant est chargé d’appeler Release via chaque pointeur énuméré. 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.

[in, 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. Ce paramètre peut être NULL si celt a la valeur 1.

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 | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête objidl.h

Voir aussi

IEnumMoniker

IMoniker