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

Статья
03/13/2024

Функция ldap_modify_s изменяет существующую запись.

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_modify_s(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] mods
);

Параметры

[in] ld

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

[in] dn

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

[in] mods

Массив изменений, вносимых в запись, завершающийся null.

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

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

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

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

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

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

Требования

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