COWAIT_FLAGS列挙 (combaseapi.h)

  • [アーティクル]

CoWaitForMultipleHandles 関数の動作を指定します。

構文

typedef enum tagCOWAIT_FLAGS {
  COWAIT_DEFAULT = 0,
  COWAIT_WAITALL = 1,
  COWAIT_ALERTABLE = 2,
  COWAIT_INPUTAVAILABLE = 4,
  COWAIT_DISPATCH_CALLS = 8,
  COWAIT_DISPATCH_WINDOW_MESSAGES = 0x10
} COWAIT_FLAGS;

定数

 
COWAIT_DEFAULT
値: 0
任意の呼び出しをディスパッチせずにマーシャリングするために必要なディスパッチ呼び出し。
COWAIT_WAITALL
値: 1
設定した場合、 CoWaitForMultipleHandles の呼び出しは、同期オブジェクトに関連付けられているすべてのハンドルが通知され、入力イベントが同時に受信された場合にのみ、S_OKを返します。 この場合、CoWaitForMultipleHandles の動作は、dwFlags パラメーターを MWMO_WAITALL に設定した MsgWaitForMultipleObjectsEx 関数の動作に対応します。 COWAIT_WAITALLが設定されていない場合、CoWaitForMultipleHandles の呼び出しは、入力イベントが受信されたかどうかに関係なく、同期オブジェクトに関連付けられているハンドルが通知されるとすぐにS_OKを返します。
COWAIT_ALERTABLE
値: 2
設定した場合、ハンドルが通知されていない場合でも、非同期プロシージャ コール (APC) が QueueUserAPC 関数の呼び出しで呼び出し元スレッドにキューに登録されている場合、CoWaitForMultipleHandles の呼び出しはS_OKを返します。
COWAIT_INPUTAVAILABLE
値: 4
設定した場合、PeekMessage などの別の関数の呼び出しを使用して入力が見られた (削除されていない) 場合でも、キューの入力が存在する場合、CoWaitForMultipleHandles の呼び出しはS_OKを返します。
COWAIT_DISPATCH_CALLS
値: 8
ASTA 内の CoWaitForMultipleHandles からの呼び出しをディスパッチします。 既定値は通話ディスパッチなしです。 この値は、他のアパートメント型では意味を持たず、無視されます。
COWAIT_DISPATCH_WINDOW_MESSAGES
値: 0x10
ASTA または STA 内の CoWaitForMultipleHandles からのウィンドウ メッセージのディスパッチを有効にします。 ASTA の既定値は、ディスパッチされたウィンドウ メッセージはありません。STA の既定値は、ディスパッチされる特殊なケース付きメッセージの小さなセットのみです。 値は MTA では意味を持たず、無視されます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header combaseapi.h (Objbase.h を含む)

関連項目

CoWaitForMultipleHandles

ISynchronize::Wait

ISynchronizeContainer::WaitMultiple