Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function converts a distinguished name to a user-friendly format.

Syntax 

UNICODE PTCHAR ldap_dn2ufn(
  UNICODE PTCHAR 
dn
);

Parameters

dn

[in] Distinguished name to convert.

Return Value

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

If this function fails, the return value is NULL.

Remarks

When given an entry's distinguished name, this function returns a character string containing the entry name in a user-friendly format. The nature of the user-friendly format depends on the directory service implementation and the type of entry. The return value remains in memory-allocated space until you call the ldap_memfreefunction.

Requirements

Header winldap.h
Library wldap32.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ldap_memfree