Metodo IEnumString::Next (objidl.h)

Articolo
02/29/2024

Recupera il numero specificato di elementi nella sequenza di enumerazione.

Sintassi

HRESULT Next(
  [in]  ULONG    celt,
  [out] LPOLESTR *rgelt,
  [out] ULONG    *pceltFetched
);

Parametri

[in] celt

Numero di elementi da recuperare. Se nella sequenza sono rimasti meno del numero di 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.

[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 viene 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	objidl.h (include ObjIdl.h)

Vedi anche

Ienumstring