RoActivateInstance 函数 (roapi.h)

激活指定的Windows 运行时类。

语法

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

[in] activatableClassId

类型： HSTRING

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

[out] instance

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

类型： HRESULT

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

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

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