Método IOpcPartEnumerator::Clone (msopc.h)

Artigo
03/05/2024

Cria uma cópia do enumerador atual e de todos os seus descendentes.

Sintaxe

HRESULT Clone(
  [out, retval] IOpcPartEnumerator **copy
);

Parâmetros

[out, retval] copy

Um ponteiro para a interface IOpcPartEnumerator do novo enumerador.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor/código retornado	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro de cópia é NULL.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	O enumerador é inválido porque o conjunto subjacente foi alterado.

Comentários

Quando um enumerador é criado, a posição atual precede o primeiro ponteiro. Para definir a posição atual como o primeiro ponteiro do enumerador, chame o método MoveNext depois de criar o enumerador.

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h