設定屬性

HTTP Server 2.0 版 API 可讓應用程式手動設定要求佇列、伺服器會話和 URL 群組。 伺服器會話是最上層物件,其中包含套用至它們下建立的所有 URL 群組的組態資訊。 應用程式會在其中建立一或多個 URL 群組的伺服器會話,然後將 URL 群組與要求佇列產生關聯。

如需 HTTP Server 2.0 版 API 中特定組態物件的詳細資訊,請參閱:

組態物件的屬性是使用 HttpSetServerSessionPropertyHttpSetUrlGroupPropertyHttpSetRequestQueueProperty 來設定,如下圖所示。 要求佇列與 URL 群組之間的關聯可以視需要變更,而伺服器會話與 URL 群組之間的關聯無法變更。 URL 群組必須與要求佇列相關聯,才能接收要求。

properties for the configuration objects

下表列出可在每個組態物件上設定的屬性。 一般而言,如果應用程式未設定任何屬性組態,則會套用 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