RoInitialize 函数 (roapi.h)

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

Syntax

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

参数

[in] initType

类型: RO_INIT_TYPE

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

返回值

类型:HRESULT

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

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

注解

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

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

要求

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

另请参阅

CoInitializeEx

RO_INIT_TYPE

RoUninitialize