ldap_get_dn
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_entry or ldap_next_entry. When the returned name is no longer needed, free the string by calling the ldap_memfree function.
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 |