ldap_modify_ext

Asynchronously modifies specified attributes of an entry on an LDAP server, 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_modify_ext (
     LDAP           *ld,
     const char     *dn,
     LDAPMod       **mods,
     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 modify.

mods

(IN) Points to a NULL-terminated array of pointers to the modifications to make to the entry. Each LDAPMod structure contains the modifications for one attribute.

serverctrls

(IN) Points to an array of LDAPControl structures that list the server controls to use with the modify 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 modify operation. Use NULL to specify no client controls.

msgidp

(OUT) Points to the message ID of the request when the search request succeeds.

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

If successful, the message ID of the operation is placed in the msgidp parameter. To obtain the results of the operation, call the ldap_result function using the message ID returned in the msgidp parameter.

Use the ldap_rename or ldap_rename_s function to modify the entry's name.

eDirectory does not currently support any server-side controls to use with modify operations.

See Also

ldap_modify, ldap_modify_s, ldap_modify_ext_s