Método IEnumFORMATETC::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]     FORMATETC *rgelt,
  [in, 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.

[in, out] pceltFetched

Número de elementos recuperados. Este parámetro siempre es menor o igual que el número de elementos solicitados. Este parámetro puede ser NULL si celt es 1.

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	objidl.h

Consulte también

FORMATETC

IEnumFORMATETC