Partilhar via

Função SpawnDerivedClass

Cria um objeto de classe recentemente derivado a partir de um objeto especificado.

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 SpawnDerivedClass (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [in] LONG                 lFlags,
   [out] IWbemClassObject**  ppNewClass);

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.

ppNewClass
[fora] Recebe o ponteiro para o novo objeto de definição de classe. Se ocorrer um erro, não é devolvido um novo objeto e ppNewClass não é modificado. O respetivo valor não pode ser null.

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_FAILED 0x80041001 Ocorreu uma falha geral.
WBEM_E_INVALID_OPERATION 0x80041016 Foi pedida uma operação inválida, como gerar uma classe de uma instância.
WBEM_E_INCOMPLETE_CLASS A classe de origem não foi completamente definida ou registada na Gestão do Windows, pelo que não é permitida uma nova classe derivada.
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 de função foi efetuada com êxito.

Observações

Esta função encapsula uma chamada para o método IWbemClassObject::SpawnDerivedClass .

ptr tem de ser uma definição de classe que se torne a classe principal do objeto gerado. O objeto devolvido torna-se uma subclasse do objeto atual.

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 do Sistema.

Cabeçalho: WMINet_Utils.idl

.NET Framework Versões: Disponível desde 4.7.2

Ver também

  • Last updated on