ldap_get_values函式 (winldap.h)

發行項
08/27/2023

ldap_get_values函式會擷取指定屬性的值清單。

語法

WINLDAPAPI PCHAR *LDAPAPI ldap_get_values(
  [in] LDAP        *ld,
  [in] LDAPMessage *entry,
  [in] const PSTR  attr
);

參數

[in] ld

會話控制碼。

[in] entry

要從中擷取值的專案。

[in] attr

Null 終止字串的指標，其中包含要擷取其值的屬性。

傳回值

如果函式成功，它會傳回值的 Null 終止指標清單。如果找不到屬性值，它通常會傳回 Null。但在某些情況下，它可能會傳回一個值為 Null的清單。請務必使用 ldap_count_values 來取得傳回清單中的值計數，如中所述。在任一情況下，LDAP 資料結構中的會話錯誤參數會設定為 0。

如果函式失敗，它會傳回 Null ，而且 LDAP 資料結構中的會話錯誤參數會設定為 LDAP 錯誤碼。

備註

剖析搜尋回應以取得屬性的值或值時，請使用 ldap_get_values 。只有當屬性包含 Null 終止的字元字串時，才使用此函式;針對二進位資料，請改用 ldap_get_values_len 。

呼叫 ldap_first_entry 或 ldap_next_entry來取得專案。屬性應該是呼叫 ldap_first_attribute、 ldap_next_attribute或呼叫端提供的字串所傳回的 (字串，例如「mail」) 。

使用 ldap_count_values 來取得傳回清單中的值計數。呼叫 ldap_value_free ，以在不再需要時釋放傳回的值。

某些 LDAP 伺服器會限制在單一呼叫中傳回的屬性字串值數目。如需使用範圍擷取規範的詳細資訊，請參閱使用範圍擷取進行搜尋。

規格需求


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