ldap_dn2ufn

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

PCHAR ldap_dn2ufn(
  PCHAR dn
);

Parameters

dn

[in] The distinguished name to convert.

Return Values

If the function is successful, it returns the user-friendly name as a character string.

If the function fails, the return value is NULL.

Remarks

When given an entry's distinguished name, ldap_dn2ufn returns a character string containing the entry name in a user-friendly format. The nature of the user-friendly format 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

  Windows NT/2000: Requires Windows NT 4.0 SP4 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Winldap.h.
  Library: Use Wldap32.lib.
  Unicode: Declared as Unicode and ANSI prototypes.

See Also

Functions, ldap_memfree