共用方式為


HTTPWaitForDisconnect 函式 (HTTP.h)

HttpWaitForDisconnect函式會在對 HTTP 用戶端的連線因任何原因而中斷時通知應用程式。

語法

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

參數

[in] RequestQueueHandle

處理來自指定連接之要求之要求佇列的控制碼。 系統會建立要求佇列,並透過呼叫 HttpCreateRequestQueue 函式傳回其控制碼。

Windows Server 2003 SP1 和 Windows XP SP2: 要求佇列的控制碼是由 HttpCreateHttpHandle 函式所建立。

[in] ConnectionId

與用戶端電腦連線的識別碼。 呼叫HttpReceiveHttpRequest函式時,會在HTTP_REQUEST結構的ConnectionID成員中傳回此值。

[in] Overlapped

針對非同步呼叫,請將 pOverlapped 設定為指向 重迭 結構;若為同步呼叫,請將它設定為 Null

同步呼叫會封鎖直到連線中斷為止,而非同步呼叫會立即傳回ERROR_IO_PENDING,而呼叫應用程式接著會使用 GetOverlappedResult 或 I/O 完成埠來判斷作業何時完成。 如需使用 重迭 結構進行同步處理的詳細資訊,請參閱 同步處理和重迭的輸入和輸出

傳回值

如果函式成功,傳回值會NO_ERROR。

如果以非同步方式使用函式,ERROR_IO_PENDING的傳回值表示下一個要求尚未就緒,且稍後會透過一般重迭的 I/O 完成機制擷取。

如果函式失敗,傳回值就是下列其中一個錯誤碼。

意義
ERROR_INVALID_PARAMETER
提供的一或多個參數格式為無法使用。
其他
WinError.h 中定義的 系統錯誤碼

需求

   
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 HTTP.h
程式庫 Httpapi.lib
Dll Httpapi.dll

另請參閱

HTTP 伺服器 API 1.0 版函式

HTTP_REQUEST