Méthode IEnumOleDocumentViews ::Next (docobj.h)

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

Syntaxe

HRESULT Next(
  [in]      ULONG            cViews,
  [out]     IOleDocumentView **rgpView,
  [in, out] ULONG            *pcFetched
);

Paramètres

[in] cViews

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.

Si pcFetched a lavaleur NULL, ce paramètre doit être 1.

[out] rgpView

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 cViews est supérieur à 1, l’appelant doit également passer un pointeur non NULL passé à pcFetched pour connaître le nombre de pointeurs à libérer.

[in, out] pcFetched

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, auquel cas le paramètre cViews doit être 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.

Remarques

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 rgpView n’est valide et aucun appel à Release n’est requis.

Configuration requise

Voir aussi

IEnumOleDocumentViews

IOleDocumentView