共用方式為


RoInitialize 函式 (roapi.h)

使用指定的並行模型,初始化目前線程上的 Windows 執行時間。

語法

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 會將此執行程的並行模型指定為多執行緒 Apartment (MTA) 。 這也可能表示已發生從中性執行緒 Apartment 變更為單一執行緒 Apartment。

備註

使用 RoInitialize 函式在 Windows 執行階段中初始化執行緒。 啟用 Windows 執行階段物件並與之互動的所有執行緒都必須先初始化,才能呼叫 Windows 執行階段。

呼叫 RoUninitialize 函式,以關閉目前執行緒上的 Windows 執行階段。 每個成功呼叫 RoInitialize ,包括傳回 S_FALSE 的呼叫,都必須由對應的 RoUninitialize 呼叫來平衡。

需求

Requirement 價值觀
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平臺 窗戶
Header 羅阿皮.h
Library mincore.lib

另請參閱

CoInitializeEx

RO_INIT_TYPE

RoUninitialize