opendarwin man page for ldap_abandon

LDAP_ABANDON(3) 					     Library Functions Manual						   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  mes-
       sages.  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.

OpenLDAP 2.1.X							    RELEASEDATE 						   LDAP_ABANDON(3)