Table of Contents | Previous | Next | Index

Netscape Directory SDK 3.0 for C Programmer’s Guide
Chapter 18 Functions

ldap_compare_ext()

Asynchronously determines if an attribute of an entry contains a specified value.

Syntax

#include <ldap.h>
int ldap_compare_ext( LDAP *ld, const char *dn, 
   const char *attr, struct berval *bvalue, 
   LDAPControl **serverctrls, LDAPControl **clientctrls, 
   int *msgidp );

This function is a new version of the ldap_compare() function. If you are writing a new LDAP client, you should call this function instead of ldap_compare().

ldap_compare_ext() is an asynchronous function; it does not directly return results. If you want the results to be returned directly by the function, call the synchronous function ldap_compare_ext_s() instead. (For more information on asynchronous and synchronous functions, see "Calling Synchronous and Asynchronous Functions" on page 80.)

In order to get the results of the LDAP compare operation, you need to call the ldap_result() function and the ldap_parse_result() function. (See "Calling Asynchronous Functions" on page 82 for details.) For a list of possible result codes for an LDAP compare operation, see the result code documentation for the ldap_compare_ext_s() function.

For additional information on comparing attribute values in an entry, see "Comparing the Value of an Attribute" on page 231.

Example

See the example under "Example: Comparing a Value in an Entry (Asynchronous)" on page 239.

ld	Connection handle, which is a pointer to an `LDAP` structure containing information about the connection to the LDAP server.
dn	Distinguished name (DN) of the entry used in the comparison.
attr	Attribute type that you want to check the value against.
value	Value that you want to compare against the attribute values.
serverctrls	Pointer to an array of `LDAPControl` structures representing LDAP server controls that apply to this LDAP operation. If you do not want to pass any server controls, specify NULL for this argument.
clientctrls	Pointer to an array of `LDAPControl` structures representing LDAP client controls that apply to this LDAP operation. If you do not want to pass any client controls, specify NULL for this argument.
msgidp	Pointer to an integer that will be set to the message ID of the LDAP operation. To check the result of this operation, call `ldap_result()` and `ldap_parse_result()` functions.

ldap_compare_ext()

Syntax

Parameters

Returns

Description

Example

See Also