ldap_count_values_len()--Retrieve Count of Binary Attribute Values

Syntax

 #include <ldap.h>

 struct berval {
         unsigned long bv_len;
         char  *bv_val;
 };
 
 int ldap_count_values_len(
           struct berval **bvals)

  Library Name/Service Program: QSYS/QGLDCLNT

  Default Public Authority: *USE

  Threadsafe: Yes

The ldap_count_values_len() function returns the number of values in the array returned by the ldap_get_values_len() function. The array of values returned can be freed by calling ldap_value_free_len().

Authorities and Locks

No IBM^® i authority is required.

Parameters

bvals: (Input) A pointer to a null-terminated array of pointers to berval structures, as returned by ldap_get_values_len().

Return Value

Number of Values: if the request is successful, ldap_count_values_len() returns the number of values in the array returned by the ldap_get_values_len() function.
-1: if the request was not successful.

Error Conditions

if ldap_count_values_len() is not successful, ld_errno will be set to indicate the error. See LDAP Client API Error Conditions for possible LDAP error code values. Use ldap_get_errno() function to retrieve the error information.

Error Messages

The following message may be sent from this function.

Message ID	Error Message Text
CPF3CF2 E	Error(s) occurred during running of ldap_count_values_len API.

Related Information

ldap_get_values() -- Return an attribute's values.
ldap_get_values_len() -- Return an attribute's binary values.
ldap_count_values() -- Return number of values.
ldap_value_free() -- Free memory allocated by ldap_get_values().
ldap_value_free_len() -- Free memory allocated by ldap_get_values_len().

API introduced: V4R3

[ Back to top | LDAP APIs | APIs by category ]