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_INITIALIZE_CONFIG	針對使用 HTTP 組態函式、 HttpSetServiceConfiguration、 HttpQueryServiceConfiguration、 HttpDeleteServiceConfiguration 和 HttpIsFeatureSupported 的應用程式執行初始化。
HTTP_INITIALIZE_SERVER	針對使用 HTTP 伺服器 API 的應用程式執行初始化。

[in, out] pReserved

此參數是保留的，而且必須是 NULL。

傳回值

如果函式成功，則傳回值 會NO_ERROR。

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

值	意義
ERROR_INVALID_PARAMETER	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

另請參閱

• HTTP 伺服器 API 1.0 版函式
• HttpTerminate