ldap_get_values_len函式 (winldap.h)

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

語法

WINLDAPAPI berval **LDAPAPI ldap_get_values_len(
  [in] LDAP        *ExternalHandle,
  [in] LDAPMessage *Message,
  [in] const PSTR  attr
);

[in] ExternalHandle

會話句柄。

[in] Message

LDAPMessage 結構的句柄。

[in] attr

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

如果函式成功，它會傳回包含指定屬性值之 berval 結構之指標的 Null 終止清單。如果找不到屬性值，則會傳回 NULL。在任一情況下，LDAP 數據結構中的會話錯誤參數會設定為 0。

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

剖析搜尋回應以取得屬性的值或值時，請使用 ldap_get_values_len 。當屬性包含二進位數據時，請使用此函式;對於值為 Null 終止字元字串的屬性，請使用 ldap_get_values。

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

呼叫 ldap_value_free_len ，以在不再需要時釋放傳回的值。