ldap_abandon(3ldap)


ldap_abandon -- abandon LDAP operation in progress

Synopsis

#include <lber.h> 
#include <ldap.h> 

int ldap_abandon(LDAP *ld, int msgid);

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 functions such as ldap_search(3ldap) and ldap_modify(3ldap).

ldap_abandon checks to see if the result of the operation has already been returned. 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(3ldap).

Return values

ldap_abandon returns 0 on success, otherwise -1. See ldap_perror(3ldap) for details of errors.

References

Intro(3ldap), ldap_perror(3ldap), ldap_result(3ldap)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.