Metodo IEnumOleUndoUnits::Next (ocidl.h)
Recupera il numero specificato di elementi nella sequenza di enumerazione.
Sintassi
HRESULT Next(
[in] ULONG cElt,
[out] IOleUndoUnit **rgElt,
[out] ULONG *pcEltFetched
);
Parametri
[in] cElt
Numero di elementi da recuperare. Se nella sequenza sono presenti meno elementi richiesti, questo metodo recupera gli elementi rimanenti.
[out] rgElt
Matrice di elementi enumerati.
L'enumeratore è responsabile della chiamata a AddRef e il chiamante è responsabile della chiamata a Release tramite ogni puntatore enumerato. Se cElt è maggiore di 1, il chiamante deve anche passare un puntatore non NULL passato a pcEltFetched per sapere quanti puntatori rilasciare.
[out] pcEltFetched
Numero di elementi recuperati. Questo parametro è sempre minore o uguale al numero di elementi richiesti.
Valore restituito
Se il metodo recupera il numero di elementi richiesti, il valore restituito è S_OK. In caso contrario, è S_FALSE.
Commenti
Il chiamante è responsabile della chiamata al metodo Release per ogni elemento della matrice una volta restituito correttamente questo metodo. Se cUndoUnits è maggiore di uno, il chiamante deve anche passare un puntatore non NULL al pcFetched per ottenere il numero di puntatori che deve rilasciare.
E_NOTIMPL non è consentito come valore restituito. Se viene restituito un valore di errore, nessuna voce nella matrice rgpcd è valida all'uscita e non richiede alcuna versione.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ocidl.h |