httpWaitForDisconnect 函数 (http.h)

  • 项目

HttpWaitForDisconnect 函数在与 HTTP 客户端的连接因任何原因中断时通知应用程序。

语法

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

parameters

[in] RequestQueueHandle

处理来自指定连接的请求的请求队列的句柄。 创建请求队列，并通过调用 HttpCreateRequestQueue 函数返回其句柄。

带 SP1 的 Windows Server 2003 和 SP2 的 Windows XP： 请求队列的句柄由 HttpCreateHttpHandle 函数创建。

[in] ConnectionId

与客户端计算机的连接标识符。 此值通过调用 HttpReceiveHttpRequest 函数在 HTTP_REQUEST 结构的 ConnectionID 成员中返回。

[in] Overlapped

对于异步调用，将 pOverlapped 设置为指向 OVERLAPPED 结构;对于同步调用，请将其设置为 NULL。

同步调用会阻止，直到连接断开，而异步调用会立即返回ERROR_IO_PENDING调用应用程序随后使用 GetOverlappedResult 或 I/O 完成端口来确定操作何时完成。 有关使用 OVERLAPPED 结构进行同步的信息，请参阅 同步和重叠输入和输出。

返回值

如果函数成功，则返回值NO_ERROR。

如果异步使用函数，则返回值ERROR_IO_PENDING指示下一个请求尚未就绪，稍后将通过正常的重叠 I/O 完成机制进行检索。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_INVALID_PARAMETER
 提供的一个或多个参数以不可用的形式提供。
其他
 WinError.h 中定义的 系统错误代码 。

要求

   
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 http.h
Library Httpapi.lib
DLL Httpapi.dll

另请参阅

HTTP 服务器 API 版本 1.0 函数

HTTP_REQUEST