Initialize 関数 (roapi.h)
Windows ランタイム API を使用するようにスレッドを初期化します。
構文
HRESULT Initialize(
RO_INIT_TYPE initType
);
パラメーター
initType
初期化するスレッドのアパートメント型を指定します。
戻り値
- S_OK - 現在のスレッドで初めて正常に初期化されました
- S_FALSE - 入れ子になった初期化に成功しました (現在のスレッドは、指定されたアパートメントの種類に対して既に初期化されています)
- E_INVALIDARG - initType 値が無効です
- CO_E_INIT_TLS - COM の内部 TLS 構造を割り当てませんでした
- E_OUTOFMEMORY - TLS 以外のスレッド単位またはアパートメント単位の構造体を割り当てませんでした
- RPC_E_CHANGED_MODE - 現在のスレッドは、指定されたものとは異なるアパートメントの種類に対して既に初期化されています。
注釈
Windows::Foundation::Initialize が変更され、 RO_INIT_TYPE 値 RO_INIT_SINGLETHREADEDの従来の STA ではなく ASA が作成されます。 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 |