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

Статья
08/27/2023

Клиент вызывает ldap_abandon для отмены внутрипроцессного асинхронного вызова LDAP.

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_abandon(
  [in] LDAP  *ld,
  [in] ULONG msgid
);

Параметры

[in] ld

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

[in] msgid

Идентификатор сообщения вызова, который требуется отменить. Асинхронные функции, такие как ldap_search и ldap_modify, возвращают этот идентификатор сообщения при запуске операции.

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

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

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

Функция ldap_abandon сначала проверяет, завершена ли операция. Если это так, идентификатор сообщения удаляется; В противном случае вызов отправляется на сервер для отмены операции. Имейте в виду, что успешный вызов ldap_abandon уничтожает идентификатор сообщения. Таким образом, вы не можете вызвать ldap_result для получения результатов с этим идентификатором сообщения, даже если сервер завершил операцию.

Ответ сервера на ldap_abandon отсутствует; Таким образом, нет никакой гарантии, что вызов достиг сервера.

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

Требования


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

См. также

Функции

ldap_result

Share via