Directory Services

ldap_get_values

The ldap_get_values function retrieves the list of values of a given attribute.

PCHAR* ldap_get_values(
  LDAP* ld,
  LDAPMessage* entry,
  PCHAR attr
);

Parameters

ld
[in] The session handle.
entry
[in] The entry from which to retrieve values.
attr
[in] A pointer to a null-terminated string that contains the attribute whose values are to be retrieved.

Return Values

If the function succeeds, it returns a null-terminated list of pointers to values. If no attribute values were found, it returns NULL. The session error parameter in the LDAP data structure is set to 0 in either case.

If the function fails, it returns NULL and the session error parameter in the LDAP data structure is set to the LDAP error code.

Remarks

Use ldap_get_values 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 ldap_get_values_len 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 ldap_value_free to release the returned value when it is no longer required.

Certain LDAP servers place limits on the number of attribute string values that are returned in a single call. For more information about using range retrieval specifiers, see Searching Using Range Retrieval.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Unicode: Implemented as Unicode and ANSI versions on all platforms.
Header: Declared in Winldap.h.
Library: Use Wldap32.lib.

See Also

Functions, ldap_first_attribute, ldap_first_entry, ldap_get_values_len, ldap_next_attribute, ldap_next_entry, ldap_value_free, Searching a Directory