COWAIT_FLAGS enumeration

Specifies the behavior of the CoWaitForMultipleHandles function.

Syntax

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

Constants

COWAIT_WAITALL

If set, the call to CoWaitForMultipleHandles will return S_OK only when all handles associated with the synchronization object have been signaled. If not set, the call will return S_OK as soon as any handle associated with the synchronization object has been signaled.

COWAIT_ALERTABLE

If set, the call to CoWaitForMultipleHandles will return S_OK if an asynchronous procedure call (APC) has been queued to the calling thread with a call to the QueueUserAPC function, even if no handle has been signaled.

COWAIT_INPUTAVAILABLE

If set, the call to CoWaitForMultipleHandles will return S_OK if input exists for the queue, even if the input has been seen (but not removed) using a call to another function, such as PeekMessage.

COWAIT_DISPATCH_CALLS

Dispatch calls from CoWaitForMultipleHandles in an ASTA. Default is no call dispatch. This value has no meaning in other apartment types and is ignored.

COWAIT_DISPATCH_WINDOW_MESSAGES

Enables dispatch of window messages from CoWaitForMultipleHandles in an ASTA or STA. Default in ASTA is no window messages dispatched, default in STA is only a small set of special-cased messages dispatched. The value has no meaning in MTA and is ignored.

Requirements

See also

CoWaitForMultipleHandles

ISynchronize::Wait

ISynchronizeContainer::WaitMultiple

Send comments about this topic to Microsoft

Build date: 5/16/2013