ldap_modrdn_s

Synchronously modifies the relative distinguished name of a specified entry. This function has been deprecated; use the ldap_rename_s function.

LDAP Version:v2 or higher
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_modrdn_s (
     LDAP         *ld,
     const char   *dn,
     const char   *newrdn);

Parameters

ld

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

dn

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

newrdn

(IN) Points to the new relative distinguished name for the entry. The entry's parent must remain the same.

Return Values

0x00

LDAP_SUCCESS

Non-zero

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

Remarks

The ldap_modrdn_s function replaces the old rdn with the value of the new rdn.

The ldap_modrdn_s function has been replaced by the ldap_rename function. Unless you need this older function for backwards compatibility, use the newer ldap_rename_s function.

See Also

ldap_rename, ldap_rename_s