共用方式為


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

另請參閱

HTTP 伺服器 API 1.0 版函式

HttpAddUrl

HttpCreateRequestQueue