ldap_next_reference 函数 (winldap.h)

ldap_next_reference 函数从搜索结果链中检索引用。

语法

WINLDAPAPI LDAPMessage *LDAPAPI ldap_next_reference(
  [in] LDAP        *ld,
  [in] LDAPMessage *entry
);

[in] ld

会话句柄。

[in] entry

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

将 ldap_next_reference 与 ldap_first_reference 结合使用，单步执行并从搜索结果链中检索延续引用的列表。

函数返回从属引用 (在搜索响应中返回的引用) 。从属引用是服务器已返回一些数据，并且该引用已传递到树中当前级别以下的其他命名上下文。若要单步执行命名上下文不驻留在服务器上的外部引用，请使用 ldap_parse_result。

无需显式释放返回的引用，因为释放消息本身时会释放该引用。