ldap_first_entry 函数 (winldap.h)

ldap_first_entry 函数返回消息的第一个条目。

语法

WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_entry(
  [in] LDAP        *ld,
  [in] LDAPMessage *res
);

[in] ld

会话句柄。

[in] res

搜索结果，通过调用某个同步搜索例程或 ldap_result获取。

如果搜索返回了有效结果，则此函数返回指向第一个结果条目的指针。如果结果集中不存在任何条目或引用，则返回 NULL。这是唯一的错误返回;在任一情况下，LDAP 数据结构中的会话错误参数都将被清除为 0。

将 ldap_first_entry 与 ldap_next_entry 结合使用，单步执行并从搜索结果链中检索条目列表。

无需显式释放返回的条目，因为它在释放消息本身时被释放。