Función RoActivateInstance (roapi.h)

Activa la clase Windows Runtime especificada.

Sintaxis

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 devuelto	Descripción
S_OK	La clase se activó correctamente.
E_POINTER	la instancia de es NULL.
CO_E_NOTINITIALIZED	El subproceso no se ha inicializado en el 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 .

Comentarios

Use la función RoActivateInstance para activar una clase Windows Runtime. La función RoActivateInstance se conecta al generador de activación asociado 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

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	roapi.h

Consulte también

Cocreateinstance

IActivationFactory

IInspectable

TrustLevel