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

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

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_compare_s(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR attr,
  [in] PSTR       value
);

Параметры

[in] ld

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

[in] dn

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

[in] attr

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

[in] value

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

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

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

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

Комментарии

Функция ldap_compare_s инициирует синхронную операцию сравнения, сравнивая значение атрибута с известным строковым значением. Используйте ldap_compare_ext_s , если необходимо сравнить двоичные значения. Используйте ldap_compare или ldap_compare_ext для выполнения асинхронной операции сравнения.

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

Примечание При подключении к серверу LDAP 2 приложение должно выполнить операцию привязки (путем вызова одной из ldap_bind или ldap_simple_bind подпрограмм) перед попыткой выполнения других операций.

 

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	winldap.h
Библиотека	Wldap32.lib
DLL	Wldap32.dll

См. также

Функции

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

ldap_bind

ldap_compare

ldap_compare_ext

ldap_compare_ext_s

ldap_simple_bind