функция ldap_abandon (winldap.h)
Клиент вызывает 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 |