Partilhar via


Método SWbemObject.Clone_

O método Clone_ do objeto SWbemObject retorna um novo objeto que é um clone do objeto atual.

Para obter uma explicação dessa sintaxe, confira Convenções de documentação para a API de Script.

Sintaxe

objWbemObject = .Clone_( _
)

Parâmetros

Esse método não tem parâmetros.

Retornar valor

Se tiver êxito, esse método retornará um novo objeto SWbemObject.

Códigos do Erro

Após a conclusão do método Clone_, o objeto Err poderá conter um dos códigos de erro abaixo.

wbemErrFailed – 2147749889 (0x80041001)

Erro não especificado.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Nada foi especificado como parâmetro, o que não é válido nesse uso.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Não há memória suficiente para clonar o objeto.

Comentários

Use o método Clone_ para duplicar uma definição ou uma instância de classe. Isso é útil quando você precisa da cópia original do objeto para fins de backup enquanto modifica uma nova cópia. Da mesma forma, use esse método para criar muitas instâncias com base em uma só instância de origem. Por exemplo, use SWbemObject.SpawnInstance_ para criar uma instância inicial e use SWbemObject.Clone_ para produzir 100 cópias da instância rapidamente. Posteriormente, você poderá modificar os objetos, dando valores específicos a cada um deles.

Não é possível usar esse método para converter uma definição de classe em uma instância nem para 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
Cabeçalho
Wbemdisp.h
Biblioteca de tipos
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemObject
IID
IID_ISWbemObject