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，以及下列值。

傳回碼	描述
S_OK	Windows 執行階段在此線程上已成功初始化。
S_FALSE	Windows 執行階段已在此線程上初始化。
RPC_E_CHANGED_MODE	先前呼叫 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