ldap_delete_ext_s

Synchronously 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_s (
     LDAP           *ld,
     const char     *dn,
     LDAPControl   **serverctrls,
     LDAPControl   **clientctrls);

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.

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.

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

For sample code, see delentry.c.

See Also

ldap_delete, ldap_delete_s, ldap_delete_ext