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

Функция ldap_rename_ext_s — это синхронная операция, которая изменяет различающееся имя записи в каталоге. Эта функция доступна в ldap 3.

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_rename_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] const PSTR    NewRDN,
  [in] const PSTR    NewParent,
  [in] INT           DeleteOldRdn,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

Параметры

[in] ld

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

[in] dn

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

[in] NewRDN

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

[in] NewParent

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

[in] DeleteOldRdn

Значение TRUE , если старое относительное различающееся имя должно быть удалено; False , если старое относительное различающееся имя должно быть сохранено.

[in] ServerControls

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

[in] ClientControls

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

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

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

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

Комментарии

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

Требования

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

См. также раздел

Расширенные элементы управления

Функции

Изменение записи каталога

Использование элементов управления