ldap_dn2ufn function

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

Syntax

PCHAR ldap_dn2ufn(
  _In_ PCHAR dn
);

Parameters

dn [in]

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