Directory Services

ldap_get_values_len

The ldap_get_values_len function retrieves the list of values for a given attribute.

struct berval** ldap_get_values_len(
  LDAP* ExternalHandle,
  LDAPMessage* Message,
  PCHAR attr
);

Parameters

ExternalHandle
[in] The session handle.
Message
[in] Handle to the LDAPMessage structure.
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 berval structures that contain the values of the specified attribute. 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_len 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 ldap_get_values.

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

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

berval, Functions, ldap_first_attribute, ldap_first_entry, ldap_get_values, ldap_next_attribute, ldap_next_entry, ldap_value_free_len, LDAPMessage