Metodo IEnumFORMATETC::Next (objidl.h)

Articolo
03/09/2024

Recupera il numero specificato di elementi nella sequenza di enumerazione.

Sintassi

HRESULT Next(
  [in]      ULONG     celt,
  [out]     FORMATETC *rgelt,
  [in, 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 dell'allocazione di qualsiasi memoria e il chiamante è responsabile della liberazione. Se celt è maggiore di 1, il chiamante deve anche passare un puntatore non NULL passato a pceltFetched per sapere quanti puntatori rilasciare.

[in, out] pceltFetched

Numero di elementi recuperati. Questo parametro è sempre minore o uguale al numero di elementi richiesti. Questo parametro può essere NULL se celt è 1.

Valore restituito

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

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	objidl.h

Vedi anche

FORMATETC

IEnumFORMATETC

Condividi tramite