共用方式為


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_entryldap_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_attributeldap_next_attribute時會覆寫此緩衝區,因此,如果必須保留以供處理,則使用者應該複製屬性名稱複本。

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 winldap.h
程式庫 Wldap32.lib
Dll Wldap32.dll

另請參閱

BerElement

函式

搜尋目錄

ber_free

ldap_first_attribute

ldap_first_entry

ldap_get_values

ldap_memfree

ldap_next_entry