Método IEnumProgressItems::RemoteNext

Admite un cliente remoto que quiere recuperar un número especificado de elementos en la secuencia de enumeración.

Sintaxis

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

Parámetros

celt [in]

Número de elementos que se van a recuperar.

rgelt [out]

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

pceltFetched [out]

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 siguientes códigos de error 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
E_UNEXPECTED	Error inesperado. Valor: 0x8000FFFF

Comentarios

Si hay menos del 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]
IDL	Imapi2fs.idl

Consulte también

IEnumProgressItems

IEnumProgressItems::Next