Función RoActivateInstance (roapi.h)

Activa la clase de Windows Runtime especificada.

Syntax

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

Parámetros

[in] activatableClassId

Tipo: HSTRING

Identificador de clase asociado a la clase en tiempo de ejecución activable.

[out] instance

Tipo: IInspectable**

Puntero a la instancia activada de la clase en tiempo de ejecución.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código de retorno	Description
S_OK	La clase se activó correctamente.
E_POINTER	la instancia es NULL.
CO_E_NOTINITIALIZED	El subproceso no se ha inicializado en Windows Runtime llamando a la función RoInitialize .
E_ACCESSDENIED	TrustLevel para la clase requiere un proceso de plena confianza.
E_NOINTERFACE	La clase especificada no implementa la interfaz IInspectable .
E_OUTOFMEMORY	No se pudo crear una instancia de la clase .

Observaciones

Usa la función RoActivateInstance para activar una clase de Windows Runtime. La función RoActivateInstance se conecta a la factoría de activación asociada al identificador de clase activable especificado, crea una instancia llamando al constructor de argumento cero en la clase y libera el generador de activación.

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
Header	roapi.h
Library	RuntimeObject.lib

Consulte también

CoCreateInstance

IActivationFactory

IInspectable

trustLevel