IEnumProgressItems ::Next, méthode (imapi2fs.h)

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

Syntaxe

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

Paramètres

[in] celt

Nombre d’éléments à récupérer.

[out] rgelt

Tableau d’interfaces IProgressItem . Vous devez libérer chaque interface dans rgelt lorsque vous avez terminé.

[out] pceltFetched

Nombre d’éléments retournés dans rgelt. Vous pouvez définir pceltFetched sur NULL si celt en est un. Sinon, initialisez la valeur de pceltFetched sur 0 avant d’appeler cette méthode.

Valeur retournée

S_OK est retourné lorsque le nombre d’éléments demandés (celt) est retourné correctement ou que le nombre d’éléments retournés (pceltFetched) est inférieur au nombre d’éléments demandés.

D’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour Description
E_POINTER
Le pointeur n’est pas valide.

Valeur : 0x80004003

E_OUTOFMEMORY
Impossible d’allouer la mémoire requise.

Valeur : 0x8007000E

E_INVALIDARG
Un ou plusieurs arguments ne sont pas valides.

Valeur : 0x80070057

Remarques

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête imapi2fs.h

Voir aussi

IEnumProgressItems

IEnumProgressItems ::RemoteNext