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