Compartilhar via

Método IEnumProgressItems::RemoteNext

  • Artigo

Dá suporte a um cliente remoto que deseja recuperar um número especificado de itens na sequência de enumeração

Sintaxe

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

Parâmetros

celt [in]

Número de itens a serem recuperados.

rgelt [out]

Matriz de interfaces IProgressItem . Você deve liberar cada interface no rgelt quando terminar.

pceltFetched [out]

Número de elementos retornados em rgelt. Você pode definir pceltFetched como NULL se celt for um. Caso contrário, inicialize o valor de pceltFetched como 0 antes de chamar esse método.

Valor retornado

S_OK é retornado quando o número de elementos solicitados (celt) é retornado com êxito ou o número de itens retornados (pceltFetched) é menor que o número de elementos solicitados.

Outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
E_POINTER
 O ponteiro não é válido.
Valor: 0x80004003
E_OUTOFMEMORY
 Falha ao alocar a memória necessária.
Valor: 0x8007000E
E_INVALIDARG
 Um ou mais argumentos não são válidos.
Valor: 0x80070057
E_UNEXPECTED
 Ocorreu uma falha inesperada.
Valor: 0x8000FFFF

Comentários

Se houver menos do que o número solicitado de elementos restantes na sequência, ele recuperará os elementos restantes.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
IDL
Imapi2fs.idl

Confira também

IEnumProgressItems

IEnumProgressItems::Next