Compartilhar via


Método IEnumCATEGORYINFO::Next (comcat.h)

Recupera o número especificado de itens na sequência de enumeração.

Sintaxe

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

Parâmetros

[in] celt

O número de itens a serem recuperados. Se houver menos do que o número solicitado de itens restantes na sequência, esse método recuperará os elementos restantes.

[out] rgelt

Uma matriz de itens enumerados.

O enumerador é responsável por alocar qualquer memória e o chamador é responsável por liberá-la. Se celt for maior que 1, o chamador também deverá passar um ponteiro não NULL passado para pceltFetched para saber quantos ponteiros liberar.

[out] pceltFetched

O número de itens que foram recuperados. Esse parâmetro é sempre menor ou igual ao número de itens solicitados.

Retornar valor

Se o método recuperar o número de itens solicitados, o valor retornado será S_OK. Caso contrário, será S_FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho comcat.h

Confira também

CATEGORYINFO

IEnumCATEGORYINFO