ldap_get_values_len (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.