針對指定的目錄專案， ldap_first_attribute 函式會傳回第一個屬性。
語法
WINLDAPAPI PCHAR LDAPAPI ldap_first_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[out] BerElement **ptr
);
參數
[in] ld
會話控制碼。
[in] entry
要逐步執行其屬性的專案，如 ldap_first_entry 或 ldap_next_entry所傳回。
[out] ptr
在內部用來追蹤專案中目前位置的指標位址。
傳回值
Null 終止字串的指標。 如果函式成功，它會傳回包含目前屬性名稱之已配置緩衝區的指標。 當沒有其他要逐步執行的屬性時，它會傳回 Null。 在任一情況下，LDAP 資料結構中的會話錯誤參數會設定為 0。
如果函式失敗，它會傳回 Null ，並將 LDAP 資料結構中的會話錯誤參數設定為 LDAP 錯誤碼。
備註
使用 ldap_first_attribute 搭配 ldap_next_attribute 逐步執行專案傳回的屬性類型清單。 接著，您可以在呼叫中傳遞這些屬性名稱 ，以擷 取其相關聯的值ldap_get_values。
呼叫 ldap_first_attribute配置 ，並透過 ptr 參數傳回 BerElement 結構的指標。 將此指標傳遞至 ldap_next_attribute ，以追蹤屬性清單中的目前位置。 當您完成逐步執行屬性清單且 ptr 為非Null時，請呼叫 ber_free ( ptr，0 ) 釋放指標。 請注意，您必須將此呼叫中的第二個參數傳遞為 0 (零) 。
ldap_first_attribute和ldap_next_attribute都會傳回包含目前屬性名稱之已配置緩衝區的指標。 呼叫 ldap_memfree，以不再需要時釋放此緩衝區。 因為下一次呼叫時會覆寫此緩衝區 ，ldap_first_attribute 或
ldap_next_attribute，如果必須保留以供處理，則使用者應該建立屬性名稱的複本。
規格需求
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | winldap.h |
| 程式庫 | Wldap32.lib |
| Dll | Wldap32.dll |