функция ldap_modify_ext (winldap.h)
Функция 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 |
См. также раздел
Расширенные элементы управления