CoWaitForMultipleObjects function (combaseapi.h)

A replacement for CoWaitForMultipleHandles. This replacement API hides the options for CoWaitForMultipleHandles that are not supported in ASTA.

Syntax

HRESULT CoWaitForMultipleObjects(
  [in]  DWORD        dwFlags,
  [in]  DWORD        dwTimeout,
  [in]  ULONG        cHandles,
  [in]  const HANDLE *pHandles,
  [out] LPDWORD      lpdwindex
);

Parameters

[in] dwFlags

CWMO_FLAGS flag controlling whether call/window message reentrancy is enabled from this wait. By default, neither COM calls nor window messages are dispatched from CoWaitForMultipleObjects in ASTA.

[in] dwTimeout

The timeout in milliseconds of the wait.

[in] cHandles

The length of the pHandles array. Must be <= 56.

[in] pHandles

An array of handles to waitable kernel objects.

[out] lpdwindex

Receives the index of the handle that satisfied the wait.

Return value

Same return values as CoWaitForMultipleHandles, except the ASTA-specific CO_E_NOTSUPPORTED cases instead return E_INVALIDARG from all apartment types.

Requirements

Requirement	Value
Target Platform	Windows
Header	combaseapi.h
Library	Ole32.lib
DLL	Combase.dll; Ole32.dll