ldap_abandon, ldap_abandon_ext — Abandon an LDAP operation in progress
#include <ldap.h>
int
ldap_abandon( |
LDAP * | ld, |
int | msgid) ; |
int
ldap_abandon_ext( |
LDAP * | ld, |
int | msgid, | |
LDAPControl * | sctrls[], | |
LDAPControl * | cctrls[]) ; |
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.
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.