Método IWbemClassObject::Clone (wbemcli.h)

O método IWbemClassObject::Clone retorna um novo objeto que é um clone completo do objeto atual. O novo objeto tem uma contagem de referência COM de 1.

Sintaxe

HRESULT Clone(
  [out] IWbemClassObject **ppCopy
);

Parâmetros

[out] ppCopy

Esse parâmetro não pode ser NULL. Ele recebe a cópia do objeto atual. Você deve chamar IWbemClassObject::Release nesse objeto quando ele não for mais necessário.

Um novo objeto não é retornado com erro.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Comentários

Use esse método para duplicar uma definição de classe ou para duplicar uma instância. Isso pode ser útil quando a cópia original do objeto é necessária para fins de backup enquanto uma nova cópia é modificada. Da mesma forma, use esse método para criar muitas instâncias com base em uma só instância de origem. Por exemplo, use IWbemClassObject::SpawnInstance para criar uma única instância inicial e use IWbemClassObject::Clone para produzir 100 cópias da instância rapidamente. Cada objeto pode ser modificado posteriormente para assumir seus valores específicos.

Não é possível usar esse método para converter uma definição de classe em uma instância ou converter uma instância em uma definição de classe.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (include Wbemidl.h)
Biblioteca	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll