ldap_get_values_len function (winldap.h)

The ldap_get_values_len function retrieves the list of values for a given attribute.

Syntax

WINLDAPAPI berval **LDAPAPI ldap_get_values_len(
  [in] LDAP        *ExternalHandle,
  [in] LDAPMessage *Message,
  [in] const PSTR  attr
);

Parameters

[in] ExternalHandle

The session handle.

[in] Message

Handle to the LDAPMessage structure.

[in] attr

A pointer to a null-terminated string that contains the attribute whose values are to be retrieved.

Return value

If the function succeeds, it returns a null-terminated list of pointers to berval structures that contain the values of the specified attribute. If no attribute values were found, it returns NULL. The session error parameter in the LDAP data structure is set to 0 in either case.

If the function fails, it returns NULL and the session error parameter in the LDAP data structure is set to the LDAP error code.

Remarks

Use ldap_get_values_len when parsing a search response to obtain the value or values of an attribute. Use this function when the attribute contains binary data; for attributes whose values are null-terminated character strings, use ldap_get_values.

The entry is obtained by calling ldap_first_entry or ldap_next_entry. The attribute should be one returned by a call to ldap_first_attribute, ldap_next_attribute, or a caller-supplied string (for example, "mail").

Call ldap_value_free_len to release the returned value when it is no longer required.

Requirements

See also

Functions

LDAPMessage

berval

ldap_first_attribute

ldap_first_entry

ldap_get_values

ldap_next_attribute

ldap_next_entry

ldap_value_free_len