Listing Directory Vuser Functions (MLDAP) > Alphabetical List of Functions > mldap_rename_ex

mldap_rename_ex

Example: mldap_rename_ex Listing Directory Vuser Functions (MLDAP)

Renames an entry for a specific session.

int mldap_rename_ex( MLDAP *pldap, char *transaction, char *dn, char *NewDn, LAST );
pldap An LDAP session identifier.
transaction A transaction name for this step. To instruct VuGen not to create a transaction for this step, use a NULL string, "".
dn A Distinguished Name entry. Use the following format: "DN=RDN1, RDN2,..."
newDn The new Distinguished Name entry information. Use the following format: "NewDN=RDN1, RDN2,..."
LAST A marker indicating the end of the argument list.

The mldap_rename_ex function replaces a DN entry on the LDAP server for a specific session. You can replace one or more attribute types. For example, if an employee changed their name, you can change the CN attribute. If an employee moved to a different department, you can change the OU attribute.

This function is for use with multiple sessions. For global or single sessions, use the mldap_rename function, which leaves out the session identifier.

Return Values

If this function succeeds, it returns E_OK. Otherwise, it returns a negative value.

Parameterization

The following argument(s) can be parameterized with standard parameterization: dn, NewDn