ARES_CANCEL
Section: C Library Functions (3)
Updated: 31 March 2004
Index
Return to Main Contents
NAME
ares_cancel - Cancel a resolve
SYNOPSIS
#include <ares.h>
void ares_cancel(ares_channel channel)
DESCRIPTION
The ares_cancel function cancels all lookups/requests made on the the
name service channel identified by channel. ares_cancel invokes
the callbacks for each pending query on the channel, passing a status of
ARES_ECANCELLED.
These calls give the callbacks a chance to clean up any state which
might have been stored in their arguments. If such a callback invocation adds
a new request to the channel, that request will not be cancelled by the
current invocation of ares_cancel.
SEE ALSO
ares_init(3)
ares_destroy(3)
NOTES
This function was added in c-ares 1.2.0
c-ares 1.6.0 and earlier pass a status of
ARES_ETIMEOUT
instead of
ARES_ECANCELLED.
AUTHOR
Dirk Manske
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- SEE ALSO
-
- NOTES
-
- AUTHOR
-