共用方式為

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