ldap_get_dn()

Syntax

#include <ldap.h>
char * ldap_get_dn( LDAP *ld, LDAPMessage *entry );

Parameters

ld	Connection handle, which is a pointer to an LDAP structure containing information about the connection to the LDAP server.
entry	Pointer to an entry in a chain of search results, as returned by the ldap_first_entry() and ldap_next_entry() functions.

Returns

• If successful, returns the distinguished name (DN) for the specified entry.
• If unsuccessful, returns a NULL and sets the appropriate error code in the LDAP structure. To get the error code, call the ldap_get_lderrno() function. (See "Result Codes" on page 691 for a complete listing of error codes.)

Example

#include <stdio.h>

#include <ldap.h>

...

LDAP *ld;

LDAPMessage *result, *e;

char *dn;

char *my_searchbase = "o=Airius.com";

char *my_filter = "(sn=Jensen)";

...

/* Search the directory */

if ( ldap_search_s( ld, my_searchbase, LDAP_SCOPE_SUBTREE, my_filter, 
   NULL, 0, &result ) != LDAP_SUCCESS ) {

   ldap_perror( ld, "ldap_search_s" );

   return( 1 );

}

/* For each matching entry found, print out the name of the entry.*/

for ( e = ldap_first_entry( ld, result ); e != NULL; 
   e = ldap_next_entry( ld, e ) ) {

   if ( ( dn = ldap_get_dn( ld, e ) ) != NULL ) {

      printf( "dn: %s\n", dn );

      /* Free the memory used for the DN when done */

      ldap_memfree( dn );

   }

}

/* Free the result from memory when done. */

ldap_msgfree( result );

...

See Also

Last Updated: 10/01/98 17:06:23