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 |
|
Biblioteca de tipos |
|
DLL |
|
CLSID |
CLSID_SWbemObject |
IID |
IID_ISWbemObject |