Método SWbemObject.SpawnInstance_

Use o método SpawnInstance_ do objeto SWbemObject para criar uma nova instância de uma classe. O objeto atual deve ser uma definição de classe obtida do WMI por meio de um método como SWbemServices.Get ou SWbemServices.ExecQuery. Em seguida, use essa definição de classe para criar novas instâncias. Crie cada nova instância localmente dentro do processo e chame SWbemObject.Put_ para realmente criar a instância dentro do WMI.

Observação

Há suporte para gerar uma instância de uma instância, mas a instância retornada está vazia.

Para conferir uma explicação dessa sintaxe, consulte Convenções de documentação para API de script.

Sintaxe

objNewInstance = .SpawnInstance_( _
  [ ByVal iFlags ] _
)

Parâmetros

iFlags [in, opcional]

Reservado e deve ser zero se especificado.

Retornar valor

Se tiver êxito, essa chamada retornará um objeto SWbemObject que contém uma nova instância da classe.

Códigos do Erro

Após a conclusão do método SpawnInstance_, o objeto Err pode conter um dos códigos de erro da lista a seguir.

wbemErrIncompleteClass - 2147749920 (0x80041020)

O objeto atual não é uma definição de classe válida e não pode gerar novas instâncias. Está incompleto ou não foi registrado com WMI usando SWbemObject.Put_.

wbemErrIllegalOperation - 2147749918 (0x8004101E)

Retornado se esse método for usado em uma instância em vez de uma classe.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Foi especificado um parâmetro inválido.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Não há memória suficiente para concluir a operação.

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

Confira também

SWbemObject

SWbemObject.Put_

SWbemServices.Get