設定屬性
HTTP Server 2.0 版 API 可讓應用程式手動設定要求佇列、伺服器會話和 URL 群組。 伺服器會話是最上層物件,其中包含套用至其下所建立之所有 URL 群組的組態資訊。 應用程式會在其中建立一或多個 URL 群組的伺服器會話,然後將 URL 群組與要求佇列產生關聯。
如需 HTTP Server 2.0 版 API 中特定組態物件的詳細資訊,請參閱:
組態物件的屬性是使用 HttpSetServerSessionProperty、 HttpSetUrlGroupProperty 和 HttpSetRequestQueueProperty 來設定,如下圖所示。 要求佇列與 URL 群組之間的關聯可以視需要變更,而伺服器會話與 URL 群組之間的關聯無法變更。 URL 群組必須與要求佇列相關聯,才能接收要求。
下表列出可在每個組態物件上設定的屬性。 一般而言,如果應用程式未設定任何屬性組態,則會套用 HTTP Server API 預設組態。 伺服器會話上應用程式所設定的組態屬性會覆寫整個 HTTP 伺服器 API 的組態。 URL 群組上設定的組態會覆寫伺服器會話組態,而要求佇列組態會覆寫 HTTP Server API 預設組態。
Configuration 物件 | 屬性 |
---|---|
伺服器會話 | HttpServerStateProperty HttpServerLoggingProperty HttpServerQosProperty HttpServerTimeoutsProperty HttpServerAuthenticationProperty |
URL 群組 | HttpServerStateProperty HttpServerAuthenticationProperty HttpServerLoggingProperty HttpServerQosProperty HttpServerBindingProperty HttpServerTimeoutsProperty |
要求佇列 | HttpServerStateProperty HttpServerQueueLengthProperty HttpServer503VerbosityProperty |
伺服器會話屬性定義于 HTTP_SERVER_PROPERTY 列舉中。 下表列出當應用程式未設定這些屬性時,針對每個屬性類型和 HTTP Server API 預設值所設定的屬性結構。
屬性 | 結構 | HTTP 伺服器 API 預設值 |
---|---|---|
HttpServerAuthenticatonProperty | HTTP_SERVER_AUTHENTICATION_INFO | 不需要驗證 |
HttpServerLoggingProperty | HTTP_LOGGING_INFO | 無記錄 |
HttpServerQosProperty-HttpQosSettingTypeConnectionLimit > | HTTP_CONNECTION_LIMIT_INFO | 沒有限制 |
HttpServerTimeoutsProperty | HTTP_TIMEOUT_LIMIT_INFO | 120 秒 |
HttpServerQosProperty-HttpQosSettingTypeBandwidth > | HTTP_BANDWIDTH_LIMIT_INFO | 沒有限制 |
HttpServerQueueLengthProperty | ULONG | 1000 |
HttpServerStateProperty | HTTP_STATE_INFO | 啟用 |
HttpServer503VerbosityProperty | HTTP_503_RESPONSE_VERBOSITY | HttpResponseVerbosityBasic |
HttpServerBindingProperty | HTTP_BINDING_INFO | 無 |
下表列出 HTTP 伺服器 API 組態的最小值和最大值。
屬性 | HTTP 伺服器 API 最大值和最小值 |
---|---|
HttpServerQosProperty-HttpQosSettingTypeBandwidth > | Min = MIN_ALLOWED_BANDWIDTH_THROTTLING_RATE Max = none |
HttpServerQueueLengthProperty | Min = 0xA Max = 0xFFFF |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應