Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.

Object HANDLEs

Boost.Asio provides Windows-specific classes that permit asynchronous wait operations to be performed on HANDLEs to kernel objects of the following types:

For example, to perform asynchronous operations on an event, the following object may be created:

HANDLE handle = ::CreateEvent(...);
windows::object_handle file(my_io_service, handle);

The wait() and async_wait() member functions may then be used to wait until the kernel object is signalled.

See Also

windows::object_handle, windows::basic_object_handle, windows::object_handle_service.


Windows object HANDLEs are only available at compile time when targeting Windows. Programs may test for the macro BOOST_ASIO_HAS_WINDOWS_OBJECT_HANDLE to determine whether they are supported.