функция 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. Всегда используйте 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
Header	winldap.h
Библиотека	Wldap32.lib
DLL	Wldap32.dll