HttpCreateHttpHandle 函式 (HTTP.h)
HttpCreateHttpHandle函式會建立呼叫應用程式的 HTTP 要求佇列,並傳回其控制碼。
從 HTTP Server API 2.0 版開始,應用程式應該呼叫 HttpCreateRequestQueue 來建立要求佇列;不應該使用 HttpCreateHttpHandle 。
語法
HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
[out] PHANDLE RequestQueueHandle,
[in] ULONG Reserved
);
參數
[out] RequestQueueHandle
接收要求佇列控制碼之變數的指標。
[in] Reserved
保留的。 此參數必須是零。
傳回值
如果函式成功,傳回值 會NO_ERROR。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
呼叫此函式之前,呼叫應用程式未呼叫 HttpInitialize 。 |
|
WinError.h 中定義的 系統錯誤碼 。 |
備註
要求佇列可讓呼叫端應用程式接收特定 URL 的要求。 呼叫的應用程式會使用 HttpAddUrl 函式來指定應該接收要求的 URL。
應用程式應該使用單一要求佇列來接收要求。 從單一進程使用多個要求佇列並不會增加回應時間或輸送量。
當應用程式完成接收要求時,它應該呼叫 CloseHandle 函式來關閉控制碼。
需求
最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | HTTP.h |
程式庫 | Httpapi.lib |
Dll | Httpapi.dll |