Event Handling Global Functions
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at 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.
| AtlWaitWithMessageLoop | Waits for an object to be signaled, meanwhile dispatching window messages as needed. |
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.