Share via

ldap_get_values

  • Article

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

Header winldap.h
Library wldap32.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ldap_first_attribute
ldap_first_entry
ldap_get_values_len
ldap_next_attribute
ldap_next_entry
ldap_value_free