Compartilhar via

Método IEnumFsiItems::Clone (imapi2fs.h)

  • Artigo

Cria outro enumerador que contém o mesmo estado de enumeração do atual.

Sintaxe

HRESULT Clone(
  [out] IEnumFsiItems **ppEnum
);

Parâmetros

[out] ppEnum

Recebe o ponteiro de interface para o objeto de enumeração. Se o método não for bem-sucedido, o valor dessa variável de saída será indefinido. Você deve liberar ppEnum quando terminar.

Valor retornado

S_OK é retornado com êxito, mas 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

Comentários

Usando esse método, um cliente pode registrar um ponto específico na sequência de enumeração e, em seguida, retornar a esse ponto posteriormente. O novo enumerador dá suporte à mesma interface que a original.

Requisitos

   
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]
Plataforma de Destino Windows
Cabeçalho imapi2fs.h

Confira também

IEnumFsiItems