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_context, handle);

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

See Also



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.