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の標準戻り値と、次の値を返すことができます。

リターン コード	Description
S_OK	このスレッドで Windows ランタイムが正常に初期化されました。
S_FALSE	Windows ランタイムは、このスレッドで既に初期化されています。
RPC_E_CHANGED_MODE	RoInitialize の以前の呼び出しでは、このスレッドのコンカレンシー モデルがマルチスレッド アパートメント (MTA) として指定されました。 これは、ニュートラルスレッドのアパートメントからシングルスレッドアパートメントへの変更が発生したことを示している可能性もあります。

注釈

RoInitialize 関数を使用して、Windows ランタイムでスレッドを初期化します。 Windows ランタイム オブジェクトをアクティブ化して操作するすべてのスレッドは、Windows ランタイムを呼び出す前に初期化する必要があります。

RoUninitialize 関数を呼び出して、現在のスレッドの Windows ランタイムを閉じます。 RoInitialize への呼び出しが成功するたびに(S_FALSEを返す呼び出しを含む)、RoUninitialize への対応する呼び出しによってバランスを取る必要があります。

Requirements

Requirement	価値
サポートされる最小クライアント	Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の	ウィンドウズ
Header	roapi.h
Library	mincore.lib

こちらも参照ください

CoInitializeEx の

RO_INIT_TYPE

RoUninitialize