ldap_next_reference函式 (winldap.h)

ldap_next_reference函式會從搜尋結果鏈結擷取參考。

語法

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

[in] ld

會話控制碼。

[in] entry

上一次呼叫 ldap_first_reference 或 ldap_next_reference所傳回的專案。

如果搜尋傳回有效的結果，此函式會傳回結果集中下一個結果專案的指標。如果結果集中沒有任何進一步的專案或參考存在，則會傳回 Null。這是唯一的錯誤傳回;在任一情況下，LDAP 資料結構中的會話錯誤參數會清除為 0。

使用 ldap_next_reference 搭配 ldap_first_reference 逐步執行，並從搜尋結果鏈結擷取接續參考清單。

函式會傳回次級轉介 (搜尋回應中傳回的參考) 。次級轉介是伺服器傳回一些資料，而且轉介已傳遞至樹狀結構中目前層級下方的其他命名內容。若要逐步執行命名內容不在伺服器上的外部參考，請使用 ldap_parse_result。

您不需要明確釋放傳回的參考，因為它會在訊息本身釋出時釋出。