Compartilhar via

Método IEnumMoniker::Clone (objidl.h)

  • Artigo

Cria um novo enumerador que contém o mesmo estado de enumeração que o atual.

Esse método possibilita registrar um ponto específico na sequência de enumeração e, em seguida, retornar a esse ponto posteriormente. O chamador deve liberar esse novo enumerador separadamente do primeiro enumerador.

Sintaxe

HRESULT Clone(
  [out] IEnumMoniker **ppenum
);

Parâmetros

[out] ppenum

Endereço de uma variável de ponteiro IEnumMoniker que 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.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores possíveis incluem o seguinte.

Código de retorno Descrição
E_UNEXPECTED
 Ocorreu um erro inesperado.
E_INVALIDARG
 O enumerador especificado é inválido.
E_OUTOFMEMORY
 Memória insuficiente disponível para esta operação.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h

Confira também

Ienummoniker