функция ldap_compare_ext_sW (winldap.h)

Используйте функцию ldap_compare_ext_s, чтобы определить, содержит ли атрибут для данной записи известное значение.

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_compare_ext_sW(
  [in] LDAP          *ld,
  [in] const PWSTR   dn,
  [in] const PWSTR   Attr,
  [in] const PWSTR   Value,
  [in] berval        *Data,
  [in] PLDAPControlW *ServerControls,
  [in] PLDAPControlW *ClientControls
);

Параметры

[in] ld

Дескриптор сеанса.

[in] dn

Указатель на строку, завершающуюся значением NULL, которая содержит различающееся имя записи для сравнения.

[in] Attr

Указатель на строку, завершающуюся значением NULL, которая содержит атрибут для сравнения.

[in] Value

Указатель на строку, завершающуюся значением NULL, которая содержит значение атрибута строки, которое необходимо сравнить со значением атрибута. Установите значение NULL, если он не используется.

[in] Data

Значение атрибута berval по сравнению со значением атрибута. Установите значение NULL, если он не используется.

[in] ServerControls

Необязательный. Список элементов управления сервером LDAP. Установите значение NULL, если он не используется.

[in] ClientControls

Необязательный. Список клиентских элементов управления LDAP. Установите значение NULL, если он не используется.

Возвращаемое значение

Если функция выполнена успешно, а атрибут и известные значения совпадают, возвращается LDAP_COMPARE_TRUE; Если значения не совпадают, возвращается LDAP_COMPARE_FALSE.

Если функция завершается ошибкой, возвращается код ошибки. Дополнительные сведения см. в возвращаемых значений.

Замечания

Функция ldap_compare_ext_s инициирует синхронную операцию сравнения, сравнивая значение атрибута с известным значением. Параметры и эффекты ldap_compare_ext_s подсчитают параметры ldap_compare_s. Расширенная подпрограмма включает дополнительные параметры для поддержки элементов управления клиентом и сервером и сравнения двоичных значений.

Используйте параметр значения для сравнения строковых значений или используйте параметр Data для сравнения необработанных двоичных данных. Задайте для неиспользуемого параметра значение NULL. Если ни параметр не NULL, операция сравнения будет использовать значение в параметре data .

Многопоточность: вызовы к ldap_compare_ext_s являются потокобезопасны.

Заметка

Заголовок winldap.h определяет ldap_compare_ext_s как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	winldap.h
библиотеки	Wldap32.lib
DLL	Wldap32.dll

См. также

расширенных элементов управления

Функции

возвращаемых значений

использование элементов управления

berval

ldap_compare_s