Metodo IEnumCATEGORYINFO::Next (comcat.h)

Recupera il numero specificato di elementi nella sequenza di enumerazione.

Sintassi

HRESULT Next(
  [in]  ULONG        celt,
  [out] CATEGORYINFO *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 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 è S_OK. In caso contrario, è S_FALSE.

Requisiti

Vedi anche

CATEGORYINFO

IEnumCATEGORYINFO