Функция HttpWaitForDisconnect (http.h)

Статья
08/24/2023

Функция HttpWaitForDisconnect уведомляет приложение о разрыве подключения к HTTP-клиенту по какой-либо причине.

Синтаксис

HTTPAPI_LINKAGE ULONG HttpWaitForDisconnect(
  [in] HANDLE             RequestQueueHandle,
  [in] HTTP_CONNECTION_ID ConnectionId,
  [in] LPOVERLAPPED       Overlapped
);

Параметры

[in] RequestQueueHandle

Дескриптор очереди запросов, обрабатывающий запросы от указанного соединения. Создается очередь запроса, и ее дескриптор возвращается вызовом функции HttpCreateRequestQueue .

Windows Server 2003 с пакетом обновления 1 (SP1) и Windows XP с пакетом обновления 2 (SP2): Дескриптор очереди запросов создается функцией HttpCreateHttpHandle .

[in] ConnectionId

Идентификатор подключения к клиентскому компьютеру. Это значение возвращается в элементе ConnectionID структуры HTTP_REQUEST путем вызова функции HttpReceiveHttpRequest .

[in] Overlapped

Для асинхронных вызовов присвойте pOverlapped значение , указывающее на структуру OVERLAPPED ; для синхронных вызовов присвойте ему значение NULL.

Синхронный вызов блокируется до тех пор, пока подключение не будет разорвано, тогда как асинхронный вызов немедленно возвращает ERROR_IO_PENDING и вызывающее приложение затем использует порты getOverlappedResult или завершения ввода-вывода для определения времени завершения операции. Сведения об использовании структур OVERLAPPED для синхронизации см. в разделе Синхронизация и перекрытие входных и выходных данных.

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

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Один или несколько предоставленных параметров доступны в непригодном для использования виде.
Другое	Код системной ошибки, определенный в WinError.h.

Требования


Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	http.h
Библиотека	Httpapi.lib
DLL	Httpapi.dll

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

Функции API HTTP-сервера версии 1.0

HTTP_REQUEST

Поделиться через