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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in] ld

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

[in] dn

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

[in] mods

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

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

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

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

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

Как асинхронная функция ldap_modify возвращает идентификатор сообщения для операции. Вызовите ldap_result с идентификатором сообщения, чтобы получить результат операции. Чтобы отменить асинхронную операцию до ее завершения, вызовите ldap_abandon.

Если вы предпочитаете, чтобы функция возвращала результаты напрямую, используйте синхронную подпрограмму ldap_modify_s. Используйте ldap_modify_ext или ldap_modify_ext_s , если вам нужна поддержка серверных и клиентских элементов управления LDAP 3.

Многопоточность. Вызовы ldap_modify являются потокобезопасны при условии, что LdapGetLastError используется для получения фактического кода ошибки сеанса, когда вызов функции возвращает код сбоя -1.

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

Требования


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