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, em seguida, 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 obter uma explicação dessa sintaxe, consulte Convenções de Documento para a API de Script.
Sintaxe
objNewInstance = .SpawnInstance_( _
[ ByVal iFlags ] _
)
Parâmetros
-
iFlags [in, opcional]
-
Reservado e deve ser zero se especificado.
Valor retornado
Se bem-sucedida, 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 na 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. Ou ele está incompleto ou não foi registrado no 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)
-
Parâmetro inválido foi especificado.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Memória insuficiente 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 |