使用指定的並行模型,初始化目前線程上的 Windows 執行時間。
語法
HRESULT RoInitialize(
[in] RO_INIT_TYPE initType
);
參數
[in] initType
類型: RO_INIT_TYPE
執行緒的並行模型。 預設值為 RO_INIT_MULTITHREADED。
返回值
類型:HRESULT
此函式可以傳回標準傳回值 E_INVALIDARG、 E_OUTOFMEMORY 和 E_UNEXPECTED,以及下列值。
| 回傳碼 | Description |
|---|---|
|
Windows 執行階段已在此執行線上成功初始化。 |
|
Windows 執行階段已在此執行緒上初始化。 |
|
先前呼叫 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 |