Método IWbemClassObject::SpawnInstance (wbemcli.h)

  • Artigo

Use o método IWbemClassObject::SpawnInstance para criar uma nova instância de uma classe. O objeto atual deve ser uma definição de classe obtida do Gerenciamento do Windows usando IWbemServices::GetObject, IWbemServices::CreateClassEnum ou IWbemServices::CreateClassEnumAsync Em seguida, use essa definição de classe para criar novas instâncias.

Uma chamada para IWbemServices::P utInstance é necessária para realmente gravar a instância no Gerenciamento do Windows. Se você pretende descartar o objeto antes de chamar IWbemServices::P utInstance, basta fazer uma chamada para IWbemClassObject::Release.

Observe que há suporte para a geração de uma instância de uma instância, mas a instância retornada estará vazia.

Sintaxe

HRESULT SpawnInstance(
  [in]  long             lFlags,
  [out] IWbemClassObject **ppNewInstance
);

Parâmetros

[in] lFlags

Reservado. Esse parâmetro deve ser 0.

[out] ppNewInstance

Não pode ser NULL. Ele recebe uma nova instância da classe . O chamador deve invocar IWbemClassObject::Release quando o ponteiro não for mais necessário. Em caso de erro, um novo objeto não é retornado e o ponteiro é deixado inalterado.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemcli.h (include Wbemidl.h)
Biblioteca WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Confira também

IWbemClassObject

IWbemServices::GetObject

IWbemServices::PutInstance