Método IEnumString::Next (objidl.h)

Artículo
02/29/2024

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

Sintaxis

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

Parámetros

[in] celt

Número de elementos que se van a recuperar. Si hay menos elementos que el 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 no NULL pasado a pceltFetched para saber cuántos punteros 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 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	objidl.h (incluir ObjIdl.h)

Consulte también

IEnumString