Metodo IEnumOleDocumentViews::Next (docobj.h)

Recupera il numero specificato di elementi nella sequenza di enumerazione.

Sintassi

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

Parametri

[in] cViews

Numero di elementi da recuperare. Se nella sequenza sono presenti meno elementi richiesti, questo metodo recupera gli elementi rimanenti.

Se pcFetched è NULL, questo parametro deve essere 1.

[out] rgpView

Matrice di elementi enumerati.

L'enumeratore è responsabile della chiamata a AddRef e il chiamante è responsabile della chiamata a Release tramite ogni puntatore enumerato. Se cViews è maggiore di 1, il chiamante deve anche passare un puntatore non NULL passato a pcFetched per sapere quanti puntatori rilasciare.

[in, out] pcFetched

Numero di elementi recuperati. Questo parametro è sempre minore o uguale al numero di elementi richiesti. Questo parametro può essere NULL, nel qual caso il parametro cViews deve essere 1.

Valore restituito

Se il metodo recupera il numero di elementi richiesti, il valore restituito è S_OK. In caso contrario, è S_FALSE.

Commenti

E_NOTIMPL non è consentito come valore restituito. Se viene restituito un valore di errore, non sono necessarie voci nella matrice rgpView e non sono necessarie chiamate a Release.

Requisiti

Vedi anche

IEnumOleDocumentViews

IOleDocumentView