Function : LDAP

ldap_get_dn - Retrieve the name of an entry.

#include <ldap.h>
char *LNPUBLIC ldap_get_dn(

    LDAP *ld,
    LDAPMessage *entry);

Description :

This function is used to retrieve the distinguished name of an entry.

Implemented as a macro:

define ldap_get_dn(ld, entry) ND_ldap_get_dn((ld), (entry))

Parameters : Input : ld - The LDAP session handle.

entry - The entry whose name is to be retrieved, as returned by ldap_first_entry or ldap_next_entry.

Output : (routine) - A pointer to newly allocated space containg the DN. The caller SHOULD free this space by calling ldap_memfree when it is no longer in use. Note the root DN is returned as a zero length string ("").

NULL - If there is some error parsing the dn, setting error parameters in the session handle ld to indicate the error.

Sample Usage :

      if ( (sdn = ldap_get_dn( ld, e )) != NULL )
      {
          printf( "\tdn: %s\n", sdn );
          ldap_memfree( sdn );
      }