ldap_dn2ufn function (winldap.h)

The ldap_dn2ufn function converts a distinguished name to a user-friendly format.

Syntax

WINLDAPAPI PCHAR LDAPAPI ldap_dn2ufn(
  [in] const PSTR dn
);

Parameters

[in] dn

A pointer to a null-terminated string that contains the distinguished name to convert.

Return value

If the function is successful, the user-friendly name is returned as a pointer to a null-terminated character string.

If the function fails, NULL is returned.

Remarks

When given an entry distinguished name, ldap_dn2ufn returns a null-terminated character string that contains the entry name in a user-friendly format. The composition of the user-friendly format is based on the format described in RFC 1781, and depends upon the directory service implementation and the type of entry. The return value remains in memory-allocated space until you call ldap_memfree.

Requirements

See also

Functions

ldap_memfree