COINIT

列挙型フラグ

基底型i4

メンバー 4

名前	10進	16進	説明
COINIT_APARTMENTTHREADED	2	0x2	アパートメントスレッドのオブジェクト並行性用にスレッドを初期化します (「解説」を参照してください)。
COINIT_MULTITHREADED	0	0x0	マルチスレッドのオブジェクト並行性用にスレッドを初期化します (「解説」を参照してください)。
COINIT_DISABLE_OLE1DDE	4	0x4	OLE1 サポートのための DDE を無効にします。
COINIT_SPEED_OVER_MEMORY	8	0x8	パフォーマンスを向上させるために、メモリ使用量を増やします。

公式ドキュメント

このスレッドによって作成されたオブジェクトへの受信呼び出しに使用される並行性モデルを決定します。この並行性モデルは、アパートメントスレッドまたはマルチスレッドのいずれかです。

解説(Remarks)

スレッドが CoInitializeEx の呼び出しによって初期化されるとき、COINIT のメンバーのいずれかを 2 番目のパラメーターとして指定することで、そのスレッドをアパートメントスレッドとして初期化するか、マルチスレッドとして初期化するかを選択します。これにより、そのスレッドによって作成されたオブジェクトへの受信呼び出しがどのように処理されるか、つまりオブジェクトの並行性が決まります。

アパートメントスレッドは、複数の実行スレッドを許容しつつ、このスレッドによって作成されたオブジェクトのメソッドへの呼び出しが常に同じスレッド、すなわちそれらを作成したアパートメント/スレッド上で実行されることを要求することによって、すべての受信呼び出しを直列化します。さらに、呼び出しはメッセージキューの境界でのみ到着します。この直列化のため、他のメソッドの呼び出しや同じアパートメント/スレッド内の他のオブジェクトへの呼び出しによって中断されてはならない処理の間に PeekMessage や SendMessage を呼び出さないようにすること以外は、通常、オブジェクトのコードに並行性制御を記述する必要はありません。

マルチスレッド (フリースレッドとも呼ばれます) では、このスレッドによって作成されたオブジェクトのメソッドへの呼び出しを任意のスレッド上で実行できます。呼び出しの直列化は行われません。つまり、同じメソッドや同じオブジェクトに対して多数の呼び出しが同時に発生する可能性があります。マルチスレッドのオブジェクト並行性は、オブジェクトへの呼び出しがまったく直列化されないため、最も高いパフォーマンスを提供し、スレッド間、プロセス間、およびマシン間の呼び出しにおいてマルチプロセッサーハードウェアを最大限に活用します。ただしこれは、オブジェクトのコードが、クリティカルセクション、セマフォ、ミューテックスなどの同期プリミティブを使用して、独自の並行性モデルを自ら適用しなければならないことを意味します。さらに、オブジェクトは自身にアクセスするスレッドの有効期間を制御しないため、スレッド固有の状態をオブジェクト内 (スレッドローカルストレージ) に格納することはできません。

メモマルチスレッドアパートメントは、GUI 以外のスレッドで使用することを目的としています。マルチスレッドアパートメント内のスレッドは、UI の操作を行わないでください。これは、UI スレッドにはメッセージポンプが必要であるのに対し、COM はマルチスレッドアパートメント内のスレッドに対してメッセージをポンプしないためです。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum COINIT : int {
    COINIT_APARTMENTTHREADED = 2,
    COINIT_MULTITHREADED = 0,
    COINIT_DISABLE_OLE1DDE = 4,
    COINIT_SPEED_OVER_MEMORY = 8
} COINIT;

[Flags]
public enum COINIT : int
{
    COINIT_APARTMENTTHREADED = 2,
    COINIT_MULTITHREADED = 0,
    COINIT_DISABLE_OLE1DDE = 4,
    COINIT_SPEED_OVER_MEMORY = 8,
}

<Flags>
Public Enum COINIT As Integer
    COINIT_APARTMENTTHREADED = 2
    COINIT_MULTITHREADED = 0
    COINIT_DISABLE_OLE1DDE = 4
    COINIT_SPEED_OVER_MEMORY = 8
End Enum

import enum

class COINIT(enum.IntFlag):
    COINIT_APARTMENTTHREADED = 2
    COINIT_MULTITHREADED = 0
    COINIT_DISABLE_OLE1DDE = 4
    COINIT_SPEED_OVER_MEMORY = 8

// COINIT (flags)
pub const COINIT_APARTMENTTHREADED: i32 = 2;
pub const COINIT_MULTITHREADED: i32 = 0;
pub const COINIT_DISABLE_OLE1DDE: i32 = 4;
pub const COINIT_SPEED_OVER_MEMORY: i32 = 8;

// COINIT
const (
	COINIT_APARTMENTTHREADED int32 = 2
	COINIT_MULTITHREADED int32 = 0
	COINIT_DISABLE_OLE1DDE int32 = 4
	COINIT_SPEED_OVER_MEMORY int32 = 8
)

const
  COINIT_APARTMENTTHREADED = 2;
  COINIT_MULTITHREADED = 0;
  COINIT_DISABLE_OLE1DDE = 4;
  COINIT_SPEED_OVER_MEMORY = 8;

// COINIT
pub const COINIT_APARTMENTTHREADED: i32 = 2;
pub const COINIT_MULTITHREADED: i32 = 0;
pub const COINIT_DISABLE_OLE1DDE: i32 = 4;
pub const COINIT_SPEED_OVER_MEMORY: i32 = 8;

const
  COINIT_APARTMENTTHREADED* = 2
  COINIT_MULTITHREADED* = 0
  COINIT_DISABLE_OLE1DDE* = 4
  COINIT_SPEED_OVER_MEMORY* = 8

enum COINIT : int {
    COINIT_APARTMENTTHREADED = 2,
    COINIT_MULTITHREADED = 0,
    COINIT_DISABLE_OLE1DDE = 4,
    COINIT_SPEED_OVER_MEMORY = 8,
}

#define global COINIT_APARTMENTTHREADED 0x2
#define global COINIT_MULTITHREADED     0x0
#define global COINIT_DISABLE_OLE1DDE   0x4
#define global COINIT_SPEED_OVER_MEMORY 0x8
; ※フラグ列挙型。ビットORで組み合わせ可(例: FOO|BAR)。