3 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
4 <title>basic_deadline_timer::cancel (2 of 2 overloads)</title>
5 <link rel="stylesheet" href="../../../../../../doc/src/boostbook.css" type="text/css">
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7 <link rel="home" href="../../../../boost_asio.html" title="Boost.Asio">
8 <link rel="up" href="../cancel.html" title="basic_deadline_timer::cancel">
9 <link rel="prev" href="overload1.html" title="basic_deadline_timer::cancel (1 of 2 overloads)">
10 <link rel="next" href="../cancel_one.html" title="basic_deadline_timer::cancel_one">
12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
13 <table cellpadding="2" width="100%"><tr>
14 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
15 <td align="center"><a href="../../../../../../index.html">Home</a></td>
16 <td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td>
17 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
18 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
19 <td align="center"><a href="../../../../../../more/index.htm">More</a></td>
22 <div class="spirit-nav">
23 <a accesskey="p" href="overload1.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../cancel.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../boost_asio.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../cancel_one.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
26 <div class="titlepage"><div><div><h5 class="title">
27 <a name="boost_asio.reference.basic_deadline_timer.cancel.overload2"></a><a class="link" href="overload2.html" title="basic_deadline_timer::cancel (2 of 2 overloads)">basic_deadline_timer::cancel
28 (2 of 2 overloads)</a>
29 </h5></div></div></div>
31 Cancel any asynchronous operations that are waiting on the timer.
33 <pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">size_t</span> <span class="identifier">cancel</span><span class="special">(</span>
34 <span class="identifier">boost</span><span class="special">::</span><span class="identifier">system</span><span class="special">::</span><span class="identifier">error_code</span> <span class="special">&</span> <span class="identifier">ec</span><span class="special">);</span>
37 This function forces the completion of any pending asynchronous wait
38 operations against the timer. The handler for each cancelled operation
39 will be invoked with the <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">asio</span><span class="special">::</span><span class="identifier">error</span><span class="special">::</span><span class="identifier">operation_aborted</span></code>
43 Cancelling the timer does not change the expiry time.
46 <a name="boost_asio.reference.basic_deadline_timer.cancel.overload2.h0"></a>
47 <span class="phrase"><a name="boost_asio.reference.basic_deadline_timer.cancel.overload2.parameters"></a></span><a class="link" href="overload2.html#boost_asio.reference.basic_deadline_timer.cancel.overload2.parameters">Parameters</a>
49 <div class="variablelist">
50 <p class="title"><b></b></p>
51 <dl class="variablelist">
52 <dt><span class="term">ec</span></dt>
54 Set to indicate what error occurred, if any.
59 <a name="boost_asio.reference.basic_deadline_timer.cancel.overload2.h1"></a>
60 <span class="phrase"><a name="boost_asio.reference.basic_deadline_timer.cancel.overload2.return_value"></a></span><a class="link" href="overload2.html#boost_asio.reference.basic_deadline_timer.cancel.overload2.return_value">Return
64 The number of asynchronous operations that were cancelled.
67 <a name="boost_asio.reference.basic_deadline_timer.cancel.overload2.h2"></a>
68 <span class="phrase"><a name="boost_asio.reference.basic_deadline_timer.cancel.overload2.remarks"></a></span><a class="link" href="overload2.html#boost_asio.reference.basic_deadline_timer.cancel.overload2.remarks">Remarks</a>
71 If the timer has already expired when <code class="computeroutput"><span class="identifier">cancel</span><span class="special">()</span></code> is called, then the handlers for asynchronous
74 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
76 have already been invoked; or
79 have been queued for invocation in the near future.
83 These handlers can no longer be cancelled, and therefore are passed an
84 error code that indicates the successful completion of the wait operation.
87 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
88 <td align="left"></td>
89 <td align="right"><div class="copyright-footer">Copyright © 2003-2014 Christopher M. Kohlhoff<p>
90 Distributed under the Boost Software License, Version 1.0. (See accompanying
91 file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
96 <div class="spirit-nav">
97 <a accesskey="p" href="overload1.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../cancel.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../boost_asio.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../cancel_one.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>