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.