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