Share via


ldap_get_values_len (Windows Embedded CE 6.0)

1/6/2010

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
Windows Embedded CE Windows CE .NET 4.0 and later

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