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。

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

值	意義
ERROR_DLL_INIT_FAILED	呼叫此函式之前，呼叫應用程式未呼叫 HttpInitialize 。
其他	WinError.h 中定義的系統錯誤碼。

要求佇列可讓呼叫端應用程式接收特定 URL 的要求。呼叫的應用程式會使用 HttpAddUrl 函式來指定應該接收要求的 URL。

應用程式應該使用單一要求佇列來接收要求。從單一進程使用多個要求佇列並不會增加回應時間或輸送量。

當應用程式完成接收要求時，它應該呼叫 CloseHandle 函式來關閉控制碼。


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