ldap_first_reference 函数 (winldap.h)

ldap_first_reference函数返回消息中的第一个引用。

语法

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

[in] ld

会话句柄。

[in] res

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

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

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

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

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