Metodo IEnumUnknown::Next (objidlbase.h)

Articolo
02/29/2024

Recupera il numero specificato di elementi nella sequenza di enumerazione.

Sintassi

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	objidlbase.h (include ObjIdl.h)

Vedi anche

IEnumUnknown

IUnknown