ldap_get_values函式 (winldap.h)

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_entryldap_next_entry來取得專案。 屬性應該是呼叫 ldap_first_attributeldap_next_attribute或呼叫端提供的字串所傳回的 (字串,例如「mail」) 。

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

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

規格需求

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

請參閱

函式

搜尋目錄

ldap_first_attribute

ldap_first_entry

ldap_get_values_len

ldap_next_attribute

ldap_next_entry

ldap_value_free