初始化函式 (roapi.h)
初始化線程以使用 Windows 執行階段 API。
語法
HRESULT Initialize(
RO_INIT_TYPE initType
);
參數
initType
指定要初始化之線程的 Apartment 類型。
傳回值
- S_OK - 第一次在目前線程上成功初始化
- S_FALSE - 目前線程已針對指定的 Apartment 類型初始化 (成功的巢狀初始化)
- E_INVALIDARG - 無效 的 initType 值
- CO_E_INIT_TLS - 無法配置 COM 的內部 TLS 結構
- E_OUTOFMEMORY - 無法設定 TLS 以外的每一線程/每個 Apartment 結構
- RPC_E_CHANGED_MODE - 目前線程已經針對與所指定專案不同的 Apartment 類型初始化。
備註
Windows：：Foundation：：Initialize 已變更為建立 ASTA，而不是RO_INIT_TYPE值RO_INIT_SINGLETHREADED的傳統 STA。 傳統型應用程式不支援 Windows：：Foundation：：Initialize (RO_INIT_SINGLETHREADED) ，如果從 Windows 市集應用程式以外的進程呼叫，則會傳回CO_E_NOTSUPPORTED。
對於 Microsoft DirectX 應用程式，您必須使用 Windows：：Foundation：：Initialize (RO_INIT_MULTITHREADED) 初始化初始線程。
對於跨進程 EXE 伺服器，您必須使用 Windows：：Foundation：：Initialize (RO_INIT_MULTITHREADED) 初始化 伺服器的初始線程。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | roapi.h |