RoInitialize 函数 (roapi.h)

使用指定的并发模型初始化当前线程上的Windows 运行时。

语法

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

参数

[in] initType

类型: RO_INIT_TYPE

线程的并发模型。 默认值为 RO_INIT_MULTITHREADED

返回值

类型: HRESULT

此函数可以返回标准返回值 E_INVALIDARGE_OUTOFMEMORYE_UNEXPECTED,以及以下值。

返回代码 说明
S_OK
已成功在此线程上初始化Windows 运行时。
S_FALSE
Windows 运行时已在此线程上初始化。
RPC_E_CHANGED_MODE
先前对 RoInitialize 的调用将此线程的并发模型指定为 MTA) (多线程单元。 这也可能表明发生了从中性线程单元到单线程单元的更改。

注解

使用 RoInitialize 函数初始化Windows 运行时中的线程。 在调用 Windows 运行时 之前,必须初始化激活Windows 运行时对象并与之交互的所有线程。

调用 RoUninitialize 函数以关闭当前线程上的Windows 运行时。 每次成功调用 RoInitialize(包括返回 S_FALSE)都必须通过对 RoUninitialize 的相应调用来平衡。

要求

要求
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 roapi.h

另请参阅

CoInitializeEx

RO_INIT_TYPE

RoUninitialize