ldap_abandon(3)

LDAP_ABANDON(3)        C LIBRARY FUNCTIONS        LDAP_ABANDON(3)

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 opera-
     tion   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  other-
     wise, setting ld_errno with an appropriate LDAP error code.

     ldap_abandon_ext() directly returns an LDAP error code indi-
     cating 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.

OpenLDAP LDVERSION  Last change: RELEASEDATE                    1