ldap_first_attribute 函数 (winldap.h)
对于给定的目录条目， ldap_first_attribute 函数返回第一个属性。
语法
WINLDAPAPI PCHAR LDAPAPI ldap_first_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[out] BerElement **ptr
);
参数
[in] ld
会话句柄。
[in] entry
ldap_first_entry或 ldap_next_entry 返回的属性将逐步遍历 的条目。
[out] ptr
在内部用于跟踪条目中当前位置的指针的地址。
返回值
指向以 null 结尾的字符串的指针。 如果函数成功，它将返回指向包含当前属性名称的已分配缓冲区的指针。 如果没有其他要单步执行的属性，则返回 NULL。 在任一情况下，LDAP 数据结构中的会话错误参数都设置为 0。
如果函数失败，它将返回 NULL ，并将 LDAP 数据结构中的会话错误参数设置为 LDAP 错误代码。
注解
将 ldap_first_attribute 与 ldap_next_attribute 结合使用，以逐步浏览随条目一起返回的属性类型列表。 然后，可以在调用 ldap_get_values 中传递这些属性名称，以检索其关联的值。
调用 ldap_first_attribute 分配，并通过 ptr 参数返回 指向 BerElement 结构的指针。 将此指针传递给 ldap_next_attribute 以跟踪属性列表中的当前位置。 完成单步执行属性列表且 ptr 为非 NULL 时，请通过调用 ber_free ( ptr， 0 ) 释放指针。 请注意，必须在此调用中将第二个参数作为 0 (零) 传递。
ldap_first_attribute 和 ldap_next_attribute返回指向包含当前属性名称的已分配缓冲区的指针。 如果不再需要，请通过调用 ldap_memfree 释放此缓冲区。 因为下一次调用 ldap_first_attribute 或 时会覆盖此缓冲区
ldap_next_attribute，如果用户必须保留属性名称以供处理，则用户应创建该属性名称的副本。
要求
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | winldap.h |
| Library | Wldap32.lib |
| DLL | Wldap32.dll |