1LDAP_ABANDON(3)            Library Functions Manual            LDAP_ABANDON(3)
2
3
4

NAME

6       ldap_abandon, ldap_abandon_ext - Abandon an LDAP operation in progress
7

LIBRARY

9       OpenLDAP LDAP (libldap, -lldap)
10

SYNOPSIS

12       #include <ldap.h>
13
14       int ldap_abandon(LDAP *ld, int msgid);
15
16       int ldap_abandon_ext(LDAP *ld, int msgid,
17              LDAPControl *sctrls[], LDAPControl *cctrls[]);
18

DESCRIPTION

20       The  ldap_abandon() routine is used to abandon or cancel an LDAP opera‐
21       tion in progress.  The msgid passed should be the message id of an out‐
22       standing LDAP operation, as returned by ldap_search(3), ldap_modify(3),
23       etc.
24
25       ldap_abandon() checks to see if the result of the operation has already
26       come  in.  If it has, it deletes it from the queue of pending messages.
27       If not, it sends an LDAP abandon operation to the the LDAP server.
28
29       The caller can expect that the result of an  abandoned  operation  will
30       not be returned from a future call to ldap_result(3).
31
32       ldap_abandon_ext()  is  equivalent  to  ldap_abandon()  except  that it
33       allows server and client controls to be passed in  sctrls  and  cctrls,
34       respectively.
35

ERRORS

37       ldap_abandon()  returns  0 if everything goes ok, -1 otherwise, setting
38       ld_errno with an appropriate LDAP error code.
39
40       ldap_abandon_ext() directly returns an LDAP error code indicating  suc‐
41       cess or failure of the operation.
42
43       See ldap_error(3) for details.
44

SEE ALSO

46       ldap(3), ldap_result(3), ldap_error(3)
47

ACKNOWLEDGEMENTS

49       OpenLDAP   is   developed   and  maintained  by  The  OpenLDAP  Project
50       (http://www.openldap.org/).  OpenLDAP is  derived  from  University  of
51       Michigan LDAP 3.3 Release.
52
53
54
55OpenLDAP 2.3.34                    2007/2/16                   LDAP_ABANDON(3)
Impressum