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_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 |