ldap_abandon_ext(3) -- Linux man page
NAME
ldap_abandon, ldap_abandon_ext - Abandon an LDAP operation in progress
LIBRARY
OpenLDAP LDAP (libldap, -lldap)
SYNOPSIS
#include <ldap.h>
int ldap_abandon(LDAP *ld, int msgid);
int ldap_abandon_ext(LDAP *ld, int msgid,
- LDAPControl *sctrls[], LDAPControl *cctrls[]);
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.
SEE ALSO
ldap(3),
ldap_result(3),
ldap_error(3)
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.
|
