ldap_sort_entries()

Syntax

#include <ldap.h>
int ldap_sort_entries( LDAP *ld, LDAPMessage *chain, char *attr, 
   LDAP_CMP_CALLBACK *cmp );

Parameters

ld	Connection handle, which is a pointer to an LDAP structure containing information about the connection to the LDAP server.
chain	Chain of entries returned by the ldap_result() or ldap_search_s() function.
attr	Attribute to use when sorting the results. To sort by distinguished name instead of by attribute, use NULL.
cmp	Comparison function used when sorting the values. For details, see "Sorting Entries by an Attribute" on page 136.

Returns

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

Example

#include <stdio.h>

#include <string.h>

#include <ldap.h>

LDAP *ld;

LDAPMessage *result;

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

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

char *sortby = "roomNumber";

...

/* 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 );

}

/* Sort the results by room number, using strcasecmp */

if ( ldap_sort_entries( ld, &result, sortby, strcasecmp ) != LDAP_SUCCESS ) { 

   ldap_perror( ld, "ldap_sort_entries" );

   return( 1 );

}

... 

See Also

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