slapi_modrdn_internal()

Edit online

slapi_modrdn_internal() perorms an LDAP modify RDN operation to rename a directory entry from your plug-in.

Unlike the standard LDAP modify RDN operation, no LDAP result code is returned to a client. The result code is instead placed in a parameter block that is returned by the function.

Syntax
#include "slapi-plugin.h"
Slapi_PBlock *slapi_modrdn_internal( char * olddn,
				char * newrdn, int deloldrdn, LDAPControl **controls,
				int l);
Parameters
olddn
The distinguished name (DN) of the entry that you want to rename.
newdn
The new relative distinguished name (RDN) of the entry.
deloldrdn
Specifies whether you want to remove the old RDN from the entry.
  • If 1, remove the old RDN.
  • If 0, leave the old RDN as an attribute of the entry.
controls
A NULL-terminated array of LDAP controls that you want applied to the modify RDN operation.
l
Included for compatibility only. It is not used.
Returns
A new parameter block with the following parameter set is returned:
  • SLAPI_PLUGIN_INTOP_RESULT specifies the LDAP result code for the internal LDAP operation.