Método IEnumProgressItems::Next (imapi2fs.h)

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

Sintaxis

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

Parámetros

[in] celt

Número de elementos que se van a recuperar.

[out] rgelt

Matriz de interfaces IProgressItem . Debe liberar cada interfaz en rgelt cuando haya terminado.

[out] pceltFetched

Número de elementos devueltos en rgelt. Puede establecer pceltFetched enNULL si celt es uno. De lo contrario, inicialice el valor de pceltFetched en 0 antes de llamar a este método.

Valor devuelto

S_OK se devuelve cuando el número de elementos solicitados (celt) se devuelve correctamente o el número de elementos devueltos (pceltFetched) es menor que el número de elementos solicitados.

Se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto	Descripción
E_POINTER	El puntero no es válido. Valor: 0x80004003
E_OUTOFMEMORY	No se pudo asignar la memoria necesaria. Valor: 0x8007000E
E_INVALIDARG	Uno o varios argumentos no son válidos. Valor: 0x80070057

Comentarios

Si hay menos elementos que el número solicitado de elementos que quedan en la secuencia, recupera los elementos restantes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	imapi2fs.h

Consulte también

IEnumProgressItems

IEnumProgressItems::RemoteNext