ldap_modrdn

Asynchronously modifies the relative distinguished name of a specified entry. This function has been deprecated; use the ldap_rename 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 (
     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

>0

Message ID of operation

-1

Failure

Remarks

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

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

See Also

ldap_rename, ldap_rename_s