ldap_get_values 函数 (winldap.h)
ldap_get_values函数检索给定属性的值列表。
语法
WINLDAPAPI PCHAR *LDAPAPI ldap_get_values(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in] const PSTR attr
);
参数
[in] ld
会话句柄。
[in] entry
要从中检索值的条目。
[in] attr
指向以 null 结尾的字符串的指针，该字符串包含要检索其值的属性。
返回值
如果函数成功，它将返回以 null 结尾的指向值的指针列表。 如果未找到任何属性值，则通常返回 NULL。 但在某些情况下，它可能会返回一个为 NULL 的指针的列表。 始终确保使用 ldap_count_values 获取返回列表中的值的计数，如备注中所述。 在任一情况下，LDAP 数据结构中的会话错误参数都设置为 0。
如果函数失败，它将返回 NULL ，并且 LDAP 数据结构中的会话错误参数设置为 LDAP 错误代码。
注解
分析搜索响应时，请使用 ldap_get_values 来获取一个或多个特性的值。 仅当 属性包含以 null 结尾的字符串时，才使用此函数;对于二进制数据，请改用 ldap_get_values_len 。
通过调用 ldap_first_entry 或 ldap_next_entry 获取条目。 属性应是通过调用 ldap_first_attribute、 ldap_next_attribute 或调用方提供的字符串返回的， (例如“mail”) 。
使用 ldap_count_values 获取返回列表中的值的计数。 调用 ldap_value_free ，以在不再需要返回的值时释放该值。
某些 LDAP 服务器对单个调用中返回的属性字符串值的数量施加了限制。 有关使用范围检索说明符的详细信息，请参阅 使用范围检索进行搜索。
要求
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | winldap.h |
| Library | Wldap32.lib |
| DLL | Wldap32.dll |