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

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

規格需求

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

請參閱

函式

LDAPMessage

berval

ldap_first_attribute

ldap_first_entry

ldap_get_values

ldap_next_attribute

ldap_next_entry

ldap_value_free_len