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

Статья
03/04/2024

Функция ldap_result получает результат асинхронной операции.

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_result(
  [in]  LDAP          *ld,
  [in]  ULONG         msgid,
  [in]  ULONG         all,
  [in]  PLDAP_TIMEVAL timeout,
  [out] PLDAPMessage  *res
);

Параметры

[in] ld

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

[in] msgid

Идентификатор сообщения операции или константный LDAP_RES_ANY, если требуется какой-либо результат.

[in] all

Указывает, сколько сообщений извлекается в одном вызове ldap_result. Этот параметр имеет значение только для результатов поиска. Передайте константную LDAP_MSG_ONE (0x00), чтобы получить по одному сообщению за раз. Передайте LDAP_MSG_ALL (0x01), чтобы запросить получение всех результатов поиска перед возвратом всех результатов в одной цепочке. Передайте LDAP_MSG_RECEIVED (0x02), чтобы указать, что все полученные результаты должны возвращаться в цепочке результатов.

[in] timeout

Время ожидания, указывающее, как долго (в секундах) следует ожидать возврата результатов. Значение NULL приводит к тому, что ldap_result блокируется до тех пор, пока результаты не будут доступны. Значение времени ожидания, равное нулю секунд, указывает поведение опроса.

[out] res

Содержит результаты операции. Все возвращаемые результаты должны быть освобождены с помощью вызова ldap_msgfree как только они больше не требуются приложению.

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

Если функция завершается успешно, она возвращает одно из следующих значений, чтобы указать тип первого результата в параметре res . Если истекает время ожидания, функция возвращает значение 0.

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

Функция ldap_result извлекает результат предыдущей асинхронно инициированной операции. Имейте в виду, что в зависимости от способа его вызова ldap_result может фактически возвращать список или "цепочку" сообщений.

Для протокола LDAP без подключения необходимо передать как дескриптор подключения LDAP, так и идентификатор сообщения, чтобы получить правильные результаты. Время выполнения LDAP продолжает отправлять запрос до получения ответа.

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

Требования

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

См. также

Функции

ldap_msgfree

Share via