HTTP_TIMEOUT_LIMIT_INFO 結構 (HTTP.h)

發行項
02/29/2024

HTTP_TIMEOUT_LIMIT_INFO結構會定義應用程式特定的連線逾時限制。

在 URL 群組、伺服器會話或要求佇列上設定或查詢 HttpServerTimeoutsProperty 時，必須使用這個結構。

語法

typedef struct _HTTP_TIMEOUT_LIMIT_INFO {
  HTTP_PROPERTY_FLAGS Flags;
  USHORT              EntityBody;
  USHORT              DrainEntityBody;
  USHORT              RequestQueue;
  USHORT              IdleConnection;
  USHORT              HeaderWait;
  ULONG               MinSendRate;
} HTTP_TIMEOUT_LIMIT_INFO, *PHTTP_TIMEOUT_LIMIT_INFO;

成員

Flags

指定屬性是否存在的 HTTP_PROPERTY_FLAGS 結構。

EntityBody

要求實體內容到達的允許時間，以秒為單位。

當要求具有實體主體時，HTTP 伺服器 API 會開啟此定時器。定時器到期一開始會設定為已設定的值。當 HTTP 伺服器 API 在要求上收到其他資料指示時，它會重設定時器，以將另一個間隔提供給連線。

DrainEntityBody

允許 HTTP 伺服器 API 在 Keep-Alive 連線上清空實體主體的時間，以秒為單位。

在 Keep-Alive 連線上，應用程式傳送要求的響應之後，以及在要求實體主體完全抵達之前，HTTP Server API 會開始清空實體主體的其餘部分，以從用戶端到達另一個可能的管線要求。如果清空剩餘實體主體的時間超過允許的期間，則連線逾時。

RequestQueue

在應用程式挑選要求之前，允許要求保留在要求佇列中的時間，以秒為單位。

IdleConnection

閒置連接的允許時間，以秒為單位。

只有在連線的第一個要求路由傳送至應用程式之後，才會強制執行此逾時。如需詳細資訊，請參閱＜備註＞一節。

HeaderWait

允許 HTTP 伺服器 API 剖析要求標頭的時間，以秒為單位。

只有在連線的第一個要求路由傳送至應用程式之後，才會強制執行此逾時。如需詳細資訊，請參閱＜備註＞一節。

MinSendRate

回應的最小傳送速率，以每秒位元組數為單位。默認回應傳送速率為每秒 150 個字節。

若要停用此定時器，請將 MinSendRate 設定為 MAXULONG。

備註

此結構用於 HttpQueryServerSessionProperty 和 HttpSetServerSessionProperty 函式中，以設定或查詢連線逾時。下表列出預設逾時。

計時器	HTTP 伺服器 API 預設值	HTTP 伺服器 API 寬組態	應用程式特定組態
EntityBody	2 分鐘	No	Yes
DrainEntityBody	2 分鐘	No	Yes
RequestQueue	2 分鐘	No	Yes
IdleConnection	2 分鐘	Yes	限制
HeaderWait	2 分鐘	Yes	限制
MinSendRate	150 個字節/秒	No	Yes

呼叫 HttpSetServerSessionProperty 或 HttpSetUrlGroupProperty 來設定連線逾時只會影響呼叫的應用程式，而且不會設定驅動程式寬逾時限制。您可以呼叫 HttpSetServiceConfiguration，為所有 HTTP 應用程式設定閒置連線和標頭等候定時器。需要系統管理許可權，才能設定 HTTP 伺服器 API 寬逾時。 HTTP 伺服器 API 寬組態會影響電腦上的所有 HTTP 應用程式，並在關閉電腦時保存。

應用程式特定的 IdleConnection 和 HeaderWait 定時器會以有限為基礎進行設定。在剖析標頭之前，HTTP 伺服器 API 無法判斷要求相關聯的要求佇列或 URL 群組。因此，HTTP 伺服器 API 會針對連線上的第一個要求強制執行預設 IdleConnection 和 HeaderWait 定時器。 Keep-Alive 連線上的後續要求將會使用應用程式特定的逾時。

在伺服器會話上設定逾時會影響伺服器會話下的所有 URL 群組。不過，如果 URL 群組已設定逾時，則 URL 群組的設定優先於伺服器會話設定。

將伺服器會話上的逾時設定為零會導致 HTTP 伺服器 API 還原為該定時器的預設值。對於 URL 群組上設定的定時器，如果存在，則會使用伺服器會話逾時，否則會使用 HTTP 伺服器 API 預設值。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	http.h