ldap_get_values

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

UNICODE PTCHAR* ldap_get_values(
  LDAP* ld,
  LDAPMessage* entry,
  UNICODE PTCHAR attr
);

Parameters

• ld
  [in] Session handle.

• entry
  [in] Entry from which to retrieve values.

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

Return Value

If this function succeeds, it returns a null-terminated list of pointers to values.

Remarks

Use this function when parsing a search response to obtain the value or values of an attribute. Use this function only when the attribute contains null-terminated character strings; for binary data, use the ldap_get_values_len 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 function to release the returned value when it is no longer needed.

Requirements

See Also

Reference

ldap_first_attribute
ldap_first_entry
ldap_get_values_len
ldap_next_attribute
ldap_next_entry
ldap_value_free