Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function retrieves the list of values for a given attribute.
struct berval** ldap_get_values_len(LDAP* ExternalHandle,LDAPMessage* Message,UNICODE PTCHARattr);
Parameters
- ExternalHandle
[in] Session handle. - Message
[in] Handle to the LDAPMessage structure. - attr
[in] Attribute whose values are to be retrieved.
Return Values
If this function succeeds, it returns a null-terminated list of pointers to berval structures containing the values of the specified attribute.
Remarks
Use this function when parsing a search response to obtain the value or values of an attribute. Use this function when the attribute contains binary data; for attributes whose values are null-terminated character strings, use the ldap_get_values 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_len function to release the returned value when it is no longer needed.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Winldap.h.
Link Library: Wldap32.lib.
See Also
berval | ldap_first_attribute | ldap_first_entry | ldap_get_values | ldap_next_attribute | ldap_next_entry | ldap_value_free_len | LDAPMessage
Send Feedback on this topic to the authors