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

Статья
08/27/2023

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

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_modify_ext(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  LDAPModA * [] mods,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

Параметры

[in] ld

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

[in] dn

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

[in] mods

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

[in] ServerControls

Список элементов управления сервера LDAP.

[in] ClientControls

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

[out] MessageNumber

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

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

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

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

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

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

В случае успешного выполнения ldap_modify_ext передает идентификатор сообщения для операции в параметре MessageNumber . Вызовите ldap_result с идентификатором сообщения, чтобы получить результат операции. Если вы предпочитаете, чтобы функция возвращала результат напрямую, используйте синхронную расширенную функцию ldap_modify_ext_s.

Многопоточность. Вызовы ldap_modify_ext потокобезопасны.

Требования

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