RoInitialize 函式 (roapi.h)
使用指定的並行模型，初始化目前線程上的 Windows 執行階段。
語法
HRESULT RoInitialize(
[in] RO_INIT_TYPE initType
);
參數
[in] initType
類型： RO_INIT_TYPE
線程的並行模型。 預設值為 RO_INIT_MULTITHREADED。
傳回值
類型： HRESULT
此函式可以傳回標準傳回值 E_INVALIDARG、 E_OUTOFMEMORY和 E_UNEXPECTED，以及下列值。
| 傳回碼 | 描述 |
|---|---|
|
Windows 執行階段 在此線程上已成功初始化。 |
|
Windows 執行階段 已在此線程上初始化。 |
|
先前呼叫 RoInitialize 會將此線程的並行模型指定為多線程 Apartment (MTA) 。 這也表示已從中性線程 Apartment 變更為單個線程 Apartment。 |
備註
使用 RoInitialize 函式來初始化 Windows 執行階段 中的線程。 啟動和與 Windows 執行階段 對象互動的所有線程都必須在呼叫 Windows 執行階段 之前初始化。
呼叫 RoUninitialize 函式，以關閉目前線程上的 Windows 執行階段。 每個成功呼叫 RoInitialize，包括傳回 S_FALSE的呼叫，都必須由 對 RoUninitialize 的對應呼叫進行平衡。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | roapi.h |