RoInitialize 関数 (roapi.h)
指定したコンカレンシー モデルを使用して、現在のスレッドのWindows ランタイムを初期化します。
構文
HRESULT RoInitialize(
[in] RO_INIT_TYPE initType
);
パラメーター
[in] initType
種類: RO_INIT_TYPE
スレッドのコンカレンシー モデル。 既定値は RO_INIT_MULTITHREADED です。
戻り値
種類: HRESULT
この関数は、E_INVALIDARG、E_OUTOFMEMORY、およびE_UNEXPECTEDの標準戻り値と、次の値を返すことができます。
リターン コード | 説明 |
---|---|
|
このスレッドでWindows ランタイムが正常に初期化されました。 |
|
Windows ランタイムは、このスレッドで既に初期化されています。 |
|
以前の RoInitialize の呼び出しでは、このスレッドのコンカレンシー モデルがマルチスレッド アパートメント (MTA) として指定されました。 これは、ニュートラルスレッドアパートメントからシングルスレッドアパートメントへの変更が発生したことを示している可能性もあります。 |
注釈
roInitialize 関数を使用して、Windows ランタイム内のスレッドを初期化します。 Windows ランタイムを呼び出す前に、Windows ランタイム オブジェクトをアクティブ化して操作するすべてのスレッドを初期化する必要があります。
RoUninitialize 関数を呼び出して、現在のスレッドのWindows ランタイムを閉じます。 RoInitialize の呼び出しが成功するたびに、S_FALSEを返すものも含め、RoUninitialize への対応する呼び出しによってバランスを取る必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | roapi.h |