RoActivateInstance 函数 (roapi.h)

激活指定的 Windows 运行时类。

Syntax

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

参数

[in] activatableClassId

类型: HSTRING

与可激活的运行时类关联的类标识符。

[out] instance

类型: IInspectable**

指向运行时类的已激活实例的指针。

返回值

类型:HRESULT

此函数可以返回其中一个值。

返回代码 Description
S_OK
已成功激活该类。
E_POINTER
实例NULL
CO_E_NOTINITIALIZED
该线程尚未在 Windows 运行时中通过调用 RoInitialize 函数进行初始化。
E_ACCESSDENIED
类的 TrustLevel 需要完全信任过程。
E_NOINTERFACE
IInspectable 接口不是由指定的类实现的。
E_OUTOFMEMORY
未能创建类的实例。

注解

使用 RoActivateInstance 函数激活 Windows 运行时类。 RoActivateInstance 函数连接到与指定的可激活类标识符关联的激活工厂,通过调用类上的零参数构造函数来创建实例,并释放激活工厂。

要求

Requirement 价值
最低支持的客户端 Windows 8 [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows操作系统
Header roapi.h
Library mincore.lib

另请参阅

CoCreateInstance

IActivationFactory

IInspectable

TrustLevel