Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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_lenfunction instead.

The entry is obtained by calling ldap_first_entryor 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_freefunction 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