ldap_abandon_ext

Abandons an asynchronous LDAP operation already in progress using LDAP client or server controls.

LDAP Version: v3
Library:*ldapsdk.*
NDS Version:7.xx or higher
Platform:NLM, Windows (NT, 95, 98, 2000, XP, Vista 32-bit and 64-bit ), Linux (32-bit and 64-bit), Solaris, AIX, and HP-UX

Syntax

  #include <ldap.h>
  
  int ldap_abandon_ext (
     LDAP           *ld,
     int             msgid,
     LDAPControl   **serverctrls,
     LDAPControl   **clientctrls);

Parameters

ld

(IN) Points to the handle for the LDAP session.

msgid

(IN) Specifies the message ID of the asynchronous LDAP operation to abandon.

serverctrls

(IN) Points to a list of LDAP server controls to use with the abandon operation. Use NULL to specify no server controls.

clientctrls

(IN) Points to an array of LDAPControl structures that list the client controls to use with the abandon operation. Use NULL to specify no client controls.

Return Values

0x00

LDAP_SUCCESS

Non-zero

Failure. For a complete list, see LDAP Return Codes.

0x51

LDAP_SERVER_DOWN

0x53

LDAP_ENCODING_ERROR

0x59

LDAP_PARAM_ERROR

0x5A

LDAP_NO_MEMORY

Remarks

The msgid parameter must specify a message ID returned by an outstanding asynchronous LDAP operation, such as ldap_search or ldap_modify.

The ldap_abandon function checks to see if the results of the operation has already come in.

  • If not, it sends an LDAP abandon operation to the LDAP server.

  • If the results have already come in, the LDAP operation cannot be abandoned.

eDirectory does not currently support any controls to use with an abandon operation.

See Also

ldap_abandon