Compartilhar via


Função RoActivateInstance (roapi.h)

Ativa a classe do Windows Runtime especificada.

Sintaxe

HRESULT RoActivateInstance(
  [in]  HSTRING      activatableClassId,
  [out] IInspectable **instance
);

Parâmetros

[in] activatableClassId

Tipo: HSTRING

O identificador de classe associado à classe de runtime ativada.

[out] instance

Tipo: IInspectable**

Um ponteiro para a instância ativada da classe de runtime.

Valor de retorno

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Description
S_OK
A classe foi ativada com êxito.
E_POINTER
a instância é NULL.
CO_E_NOTINITIALIZED
O thread não foi inicializado no Windows Runtime chamando a função RoInitialize .
E_ACCESSDENIED
O TrustLevel para a classe requer um processo de confiança total.
E_NOINTERFACE
A interface IInspectable não é implementada pela classe especificada.
E_OUTOFMEMORY
Falha ao criar uma instância da classe.

Observações

Use a função RoActivateInstance para ativar uma classe do Windows Runtime. A função RoActivateInstance conecta-se à fábrica de ativação associada ao identificador de classe ativável especificado, cria uma instância chamando o construtor de argumento zero na classe e libera a fábrica de ativação.

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header roapi.h
Library mincore.lib

Consulte também

CoCreateInstance

IActivationFactory

IInspectable

TrustLevel