Função Clone
Retorna um novo objeto que é uma cópia completa do objeto atual.
Observação
Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.
Sintaxe
HRESULT Clone (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[out] IWbemClassObject** ppCopy
);
Parâmetros
vFunc
[in] Esse parâmetro não está em uso.
ptr
[in] Um ponteiro para uma instância IWbemClassObject.
ppCopy
[out] Um novo objeto que é um completo solitário de ptr
. Esse argumento não poderá ser null
se ele receber a cópia do objeto atual.
Valor retornado
Os seguintes valores retornados por essa função são definidos no arquivo de cabeçalho WbemCli.h, ou você pode defini-los como constantes em 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 nesse uso. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Não há memória disponível suficiente para clonar o objeto. |
WBEM_S_NO_ERROR |
0 | A chamada de função foi bem-sucedida. |
Comentários
Essa 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.
Requisitos
Plataformas: confira Requisitos do sistema.
Header: WMINet_Utils.idl
Versões do .NET Framework: Disponível desde 4.7.2