Compartilhar via


Função RoActivateInstance (roapi.h)

Ativa a classe 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 ativável.

[out] instance

Tipo: IInspectable**

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

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Descrição
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 .

Comentários

Use a função RoActivateInstance para ativar uma classe 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho roapi.h

Confira também

Cocreateinstance

IActivationFactory

IInspectable

Trustlevel