Função Clone

Devolve um novo objeto que é um clone completo do objeto atual.

Nota

Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.

Sintaxe

HRESULT Clone (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [out] IWbemClassObject**  ppCopy
);

vFunc
[in] Este parâmetro não é utilizado.

ptr
[in] Um ponteiro para uma instância IWbemClassObject .

ppCopy
[fora] Um novo objeto que é um completo solitário de ptr. Este argumento não pode ser null se receber a cópia do objeto atual.

Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código:

Constante	Valor	Descrição
`WBEM_E_FAILED`	0x80041001	Houve uma falha geral.
`WBEM_E_INVALID_PARAMETER`	0x80041008	`null` foi especificado como um parâmetro e não é legal nesta utilização.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Não existe memória suficiente disponível para clonar o objeto.
`WBEM_S_NO_ERROR`	0	A chamada da função foi efetuada com êxito.

Esta função encapsula uma chamada para o método IWbemClassObject::Clone .

O objeto clonado é um objeto COM que tem uma contagem de referência de 1.

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: WMINet_Utils.idl

.NET Framework Versões: Disponível desde a versão 4.7.2