ldap_count_values()--Retrieve Count of Attribute Values

 #include <ldap.h>
 

 int ldap_count_values(
           char          **vals)

The ldap_count_values() function returns the number of values in the array returned by the ldap_get_values() function.

Authorities and Locks

No i5/OS authority is required.

Parameters

vals

(Input) A pointer to a null-terminated array of attribute values, as returned by ldap_get_values().

Return Value

Number of Values

if the request is successful, ldap_count_values() returns the number of values in the array returned by the ldap_get_values() function.

-1

if the request was not successful.

Error Conditions

If ldap_count_values() 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.

Related Information

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