Platform SDK: Active Directory, ADSI, and Directory Services |
The ldap_get_values function retrieves the list of values of a given attribute.
PCHAR* ldap_get_values( LDAP* ld, LDAPMessage* entry, PCHAR attr );
If the function succeeds, it returns a null-terminated list of pointers to values.
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 needed.
Windows NT/2000: Requires Windows NT 4.0 SP4 or later.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in Winldap.h.
Library: Use Wldap32.lib.
Unicode: Declared as Unicode and ANSI prototypes.
Functions, ldap_first_attribute, ldap_first_entry, ldap_get_values_len, ldap_next_attribute, ldap_next_entry, ldap_value_free