共用方式為


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

備註

使用 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