Name
ldap_abandon, ldap_abandon_ext — Abandon an LDAP
operation in progress
Synopsis
#include <ldap.h>
int
ldap_abandon( |
LDAP * |
ld, |
| |
int |
msgid); |
int
ldap_abandon_ext( |
LDAP * |
ld, |
| |
int |
msgid, |
| |
LDAPControl * |
sctrls, |
| |
LDAPControl * |
cctrls); |
LIBRARY
OpenLDAP LDAP (libldap, -lldap)
DESCRIPTION
The ldap_abandon() routine is
used to abandon or cancel an LDAP operation in progress. The
msgid passed should
be the message id of an outstanding LDAP operation, as
returned by ldap_search(3), ldap_modify(3), etc.
ldap_abandon() checks to see
if the result of the operation has already come in. If it
has, it deletes it from the queue of pending messages. If
not, it sends an LDAP abandon operation to the the LDAP
server.
The caller can expect that the result of an abandoned
operation will not be returned from a future call to ldap_result(3).
ldap_abandon_ext() is
equivalent to ldap_abandon() except that it
allows server and client controls to be passed in sctrls and cctrls, respectively.
ERRORS
ldap_abandon()
returns 0 if everything goes ok, -1 otherwise, setting
ld_errno with an appropriate
LDAP error code.
ldap_abandon_ext() directly
returns an LDAP error code indicating success or failure of
the operation.
See ldap_error(3) for
details.
ACKNOWLEDGEMENTS
OpenLDAP is
developed and maintained by The OpenLDAP Project
(http://www.openldap.org/). OpenLDAP is derived from
University of Michigan LDAP 3.3 Release.
