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

Recupera el número especificado de elementos de la secuencia de enumeración.

Sintaxis

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

Parámetros

[in] cViews

Número de elementos que se van a recuperar. Si hay menos elementos que el número solicitado de elementos que quedan en la secuencia, este método recupera los elementos restantes.

Si pcFetched es NULL, este parámetro debe ser 1.

[out] rgpView

Matriz de elementos enumerados.

El enumerador es responsable de llamar a AddRef y el autor de la llamada es responsable de llamar a Release a través de cada puntero enumerado. Si cViews es mayor que 1, el autor de la llamada también debe pasar un puntero no NULL pasado a pcFetched para saber cuántos punteros liberar.

[in, out] pcFetched

Número de elementos recuperados. Este parámetro siempre es menor o igual que el número de elementos solicitados. Este parámetro puede ser NULL, en cuyo caso el parámetro cViews debe ser 1.

Valor devuelto

Si el método recupera el número de elementos solicitados, el valor devuelto se S_OK. De lo contrario, es S_FALSE.

Comentarios

E_NOTIMPL no se permite como valor devuelto. Si se devuelve un valor de error, no se requiere ninguna entrada en la matriz rgpView y no se requieren llamadas a Release.

Requisitos

Consulte también

IEnumOleDocumentViews

IOleDocumentView