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 。

當釋放訊息本身時，您不需要明確釋放傳回的參考。