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

2024-11-20

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

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_modify_sW(
  [in] LDAP          *ld,
  [in] PWSTR         dn,
  [in] LDAPModW * [] mods
);

Параметры

[in] ld

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

[in] dn

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

[in] mods

Массив изменений, завершаемых значением NULL, для внесения в запись.

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

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

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

Замечания

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

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

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

Заметка

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

Требования

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