HTTPInitialize 函式 (HTTP.h)
HttpInitialize 函式會初始化 HTTP Server API 驅動程式、啟動它、如果尚未啟動,並且為呼叫應用程式配置數據結構以支持回應佇列建立和其他作業。 在 HTTP 伺服器 API 中呼叫任何其他函式之前,請先呼叫此函式。
語法
HTTPAPI_LINKAGE ULONG HttpInitialize(
[in] HTTPAPI_VERSION Version,
[in] ULONG Flags,
[in, out] PVOID pReserved
);
參數
[in] Version
HTTP 版本。 此參數是 HTTPAPI_VERSION 結構。 針對目前的版本,請先宣告 結構的實例,並將它設定為預先定義的值 HTTPAPI_VERSION_1 ,然後再將它傳遞至 HttpInitialize。
[in] Flags
初始化選項,可包含下列其中一個或兩個值。
值 | 意義 |
---|---|
|
針對使用 HTTP 組態函式、 HttpSetServiceConfiguration、 HttpQueryServiceConfiguration、 HttpDeleteServiceConfiguration 和 HttpIsFeatureSupported 的應用程式執行初始化。 |
|
針對使用 HTTP 伺服器 API 的應用程式執行初始化。 |
[in, out] pReserved
此參數是保留的,而且必須是 NULL。
傳回值
如果函式成功,則傳回值 會NO_ERROR。
如果函式失敗,則傳回值是下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
Flags 參數包含不支援的值。 |
|
WinError.h 中定義的 系統錯誤碼 。 |
備註
應用程式完成時呼叫 HttpTerminate 。 在 Flags 參數中傳遞至 HttpInitialize 的所有相同旗標也必須傳遞至 HttpTerminate。 應用程式可以重複呼叫 HttpInitialize ,前提是每個 對 HttpInitialize 的呼叫稍後都會與 對應的 HttpTerminate 呼叫相符。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | http.h |
程式庫 | Httpapi.lib |
Dll | Httpapi.dll |