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

Article
03/02/2024

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

Share via