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

Статья
04.03.2024

Функция ldap_add_ext_s инициирует синхронную операцию добавления в дерево. Для успешного выполнения операции добавления должен существовать родительский элемент добавленной записи или родительский элемент должен быть пустым (равным различаемой имени корня).

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_add_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] LDAPModA * [] attrs,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

Параметры

[in] ld

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

[in] dn

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

[in] attrs

Массив указателей на структуры LDAPMod . Каждая структура задает один атрибут. Дополнительные сведения см. в разделе «Примечания».

[in] ServerControls

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

[in] ClientControls

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

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

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

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

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

Перед вызовом ldap_add_ext_s создайте запись, указав ее атрибуты в структурах LDAPMod . Задайте LDAP_MOD_ADD элементу mod_op каждой структуры, а члены mod_type и mod_vals соответствующим образом соответствуют вашей записи.

После завершения операции добавления ldap_add_ext_s возвращается вызывающей объекту. Используйте ldap_add_ext , если вы предпочитаете, чтобы операция выполнялась асинхронно.

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

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

ServerControls и ClientControls являются необязательными и должны иметь значение NULL , если они не используются.

Требования

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