Sun Java System Directory Server Enterprise Edition 6.2 Developer's Guide

Returns

This function returns the new DN for the entry whose previous DN was dn_olddn.