IEnumOleUndoUnits::Next, méthode (ocidl.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] IOleUndoUnit **rgElt,
[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] rgElt
Tableau d’éléments énumérés.
L’énumérateur est responsable de l’appel d’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.
[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.
Notes
L’appelant est responsable de l’appel de la méthode Release pour chaque élément du tableau une fois que cette méthode est retournée avec succès. Si cUndoUnits est supérieur à un, l’appelant doit également passer un pointeur non NULL à pcFetched pour obtenir le nombre de pointeurs qu’il doit libérer.
E_NOTIMPL n’est pas autorisé en tant que valeur de retour. Si une valeur d’erreur est retournée, aucune entrée du tableau rgpcd n’est valide à la sortie et ne nécessite aucune mise en production.
Spécifications
| 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 | ocidl.h |