ldap_get_dn (Compact 2013)

3/26/2014

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

See Also

Reference

Other LDAP Functions
LDAP
ldap_first_entry
ldap_memfree
ldap_next_entry