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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | docobj.h |