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 逐步執行並從搜尋結果鏈結擷取項目清單。

您不需要在釋放訊息本身時明確釋放傳回的專案。