Compartilhar via


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

Confira também