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

Vedi anche

IEnumOleUndoUnits

IOleUndoUnit