ldap_dn2ufn()--Convert a Distinguished Name into a User Friendly Name

 #include <ldap.h>
 
 char *ldap_dn2ufn(
               const char  *dn)

The ldap_dn2ufn() function takes a distinguished name (DN) and converts into a "friendlier" representation by removing the attribute type that is associated with each relative distinguished name (RDN). For example, the DN "cn=John Doe,ou=Widget Division,ou=Austin,o=IBM,c=US" would be returned in its "friendlier" form as "John Doe, Widget Division, Austin, IBM, US". Space for the user-friendly name will have been obtained by the API, and should be freed by the caller with a call to ldap_memfree().

Authorities and Locks

No i5/OS authority is required.

Parameters

dn

(Input) Specifies the DN to be converted (as returned from ldap_get_dn()).

Return Value

Character String

if the request was successful.

NULL

if the request was not successful.

Error Conditions

If ldap_dn2ufn() is not successful, then there was no memory available for the character string.

Error Messages

The following message may be sent from this function.

Related Information

• ldap_get_dn() -- Extract the DN from an entry.
• ldap_explode_rdn() -- Break a Relative Distinguished Name into Its Components.