IEnumProgressItems ::Next, méthode (imapi2fs.h)
Récupère un nombre spécifié d’éléments dans la séquence d’énumération.
HRESULT Next(
[in] ULONG celt,
[out] IProgressItem **rgelt,
[out] ULONG *pceltFetched
);
[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.
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 |
---|---|
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
|
Impossible d’allouer la mémoire requise.
Valeur : 0x8007000E |
|
Un ou plusieurs arguments ne sont pas valides.
Valeur : 0x80070057 |
S’il reste moins que le nombre d’éléments demandé dans la séquence, il récupère les éléments restants.
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 |