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

Artículo
03/05/2024

Recupera el número especificado de elementos de la secuencia de enumeración.

Sintaxis

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

Parámetros

[in] celt

Número de elementos que se van a recuperar. Si hay menos del número solicitado de elementos que quedan en la secuencia, este método recupera los elementos restantes.

[out] rgelt

Matriz de elementos enumerados.

El enumerador es responsable de asignar cualquier memoria y el autor de la llamada es responsable de liberarla. Si celt es mayor que 1, el autor de la llamada también debe pasar un puntero que no sea NULL pasado a pceltFetched para saber cuántos punteros se van a liberar.

[out] pceltFetched

Número de elementos recuperados. Este parámetro siempre es menor o igual que el número de elementos solicitados.

Valor devuelto

Si el método recupera el número de elementos solicitados, el valor devuelto se S_OK. De lo contrario, es S_FALSE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	comcat.h

Consulte también

CATEGORYINFO

IEnumCATEGORYINFO