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 retrieves the distinguished name for a given entry.

Syntax

UNICODE PTCHAR ldap_get_dn(
  LDAP* 
ld,
  LDAPMessage* 
entry
);

Parameters

ld

[in] Session handle.

entry

[in] Entry whose distinguished name is to be retrieved.

Return Value

If this function succeeds, it returns the distinguished name as a character string.

If this function fails, it returns NULL and sets the session error parameters in the LDAP data structure.

Remarks

This function retrieves the distinguished name for an entry that was returned by ldap_first_entryor ldap_next_entry. When the returned name is no longer needed, free the string by calling 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