Event Handling Global Functions

This function provides an event handler.

Important

The function listed in the following table cannot be used in applications that execute in the Windows Runtime.

Name Description
AtlWaitWithMessageLoop Waits for an object to be signaled, meanwhile dispatching window messages as needed.

Requirements

Header: atlbase.h

AtlWaitWithMessageLoop

Waits for the object to be signaled, meanwhile dispatching window messages as needed.

Important

This function cannot be used in applications that execute in the Windows Runtime.

BOOL AtlWaitWithMessageLoop(HANDLE hEvent);

Parameters

hEvent
[in] The handle of the object to wait for.

Return Value

Returns TRUE if the object has been signaled.

Remarks

This is useful if you want to wait for an object's event to happen and be notified of it happening, but allow window messages to be dispatched while waiting.

See also

Functions