Função SpawnInstance
Cria uma nova instância de uma classe.
Nota
Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.
Sintaxe
HRESULT SpawnInstance (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] IWbemClassObject** ppNewInstance);
Parâmetros
vFunc
[in] Este parâmetro não é utilizado.
ptr
[in] Um ponteiro para uma instância IWbemClassObject .
lFlags
[in] Reservado. Este parâmetro tem de ser 0.
ppNewInstance
[fora] Recebe o ponteiro para a nova instância da classe . Se ocorrer um erro, não será devolvido um novo objeto e ppNewInstance não será modificado.
Valor devolvido
Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código:
| Constante | Valor | Descrição |
|---|---|---|
WBEM_E_INCOMPLETE_CLASS |
0x80041020 | ptr não é uma definição de classe válida e não pode gerar novas instâncias. Está incompleta ou não foi registada na Gestão do Windows ao chamar PutClassWmi. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Não existe memória suficiente disponível para concluir a operação. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | ppNewClass é null. |
WBEM_S_NO_ERROR |
0 | A chamada da função foi efetuada com êxito. |
Observações
Esta função encapsula uma chamada para o método IWbemClassObject::SpawnInstance .
ptr tem de ser uma definição de classe obtida a partir da Gestão do Windows. (Tenha em atenção que a desova de uma instância de uma instância é suportada, mas a instância devolvida está vazia.) Em seguida, utilize esta definição de classe para criar novas instâncias. É necessária uma chamada para a função PutInstanceWmi se pretender escrever a instância na Gestão do Windows.
O novo objeto devolvido em ppNewClass torna-se automaticamente uma subclasse do objeto atual. Este comportamento não pode ser substituído. Não existe outro método através do qual as subclasses (classes derivadas) possam ser criadas.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: WMINet_Utils.idl
.NET Framework Versões: Disponível desde a versão 4.7.2
