Share via

ldap_get_values_len (Compact 2013)

  • Article

3/26/2014

This function retrieves the list of values for a given attribute.

Syntax

struct berval** ldap_get_values_len(
  LDAP* ExternalHandle,
  LDAPMessage* Message,
  UNICODE PTCHAR attr
);

Parameters

  • ExternalHandle
    [in] Session handle.
  • attr
    [in] Attribute whose values are to be retrieved.

Return Value

If this function succeeds, it returns a null-terminated list of pointers to berval structures containing the values of the specified attribute.

Remarks

Use this function 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 the ldap_get_values function instead.

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 the ldap_value_free_len function to release the returned value when it is no longer needed.

Requirements

Header

winldap.h

Library

wldap32.lib

See Also

Reference

LDAP Search Functions
berval
ldap_first_attribute
ldap_first_entry
ldap_get_values
ldap_next_attribute
ldap_next_entry
ldap_value_free_len
LDAPMessage