ldap_delete_ext

Asynchronously deletes the specified entry 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_delete_ext (
     LDAP           *ld,
     const char     *dn,
     LDAPControl   **serverctrls,
     LDAPControl   **clientctrls,
     int            *msgidp);

Parameters

ld

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

dn

(IN) Points to the distinguished name of the entry to delete.

serverctrls

(IN) Points to an array of LDAPControl structures that list the server controls to use with this delete. Use NULL to specify no server controls.

clientctrls

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

msgidp

(OUT) Points to the integer value to set as the message ID of the request. When the delete request succeeds, use ldap_result with this value to retrieve the response.

Return Values

0x00

LDAP_SUCCESS

Non-zero

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

0x53

LDAP_ENCODING_ERROR

0x5A

LDAP_NO_MEMORY

Remarks

The entry specified for the delete must be a leaf entry. If the entry has children, the delete will fail. LDAP does not support the deletion of a subtree in a single operation.

To obtain the results of the operation, call the ldap_result function with the returned message ID.

eDirectory does not currently support any server-side controls for delete operations.

See Also

ldap_delete, ldap_delete_ext_s, ldap_delete_s