WinHTTP.h) (查詢資訊旗標

WinHttpQueryHeaders會使用這些屬性和修飾詞。

WinHttpQueryHeaders會使用屬性旗標來指出要擷取的資訊。 大部分的屬性旗標都會直接對應至特定的 HTTP 標頭。 另外還有一些與特定標頭無關的特殊旗標，例如WINHTTP_QUERY_RAW_HEADERS。

WINHTTP_QUERY_ACCEPT

擷取回應可接受的媒體類型。

WINHTTP_QUERY_ACCEPT_CHARSET

擷取回應可接受的字元集。

WINHTTP_QUERY_ACCEPT_ENCODING

擷取回應可接受的內容編碼值。

WINHTTP_QUERY_ACCEPT_LANGUAGE

擷取回應可接受的自然語言。

WINHTTP_QUERY_ACCEPT_RANGES

擷取資源接受的範圍要求類型。

WINHTTP_QUERY_AGE

擷取 Age 回應標頭欄位，其中包含寄件者在原始伺服器上產生回應之後的時間量估計值。

WINHTTP_QUERY_ALLOW

接收伺服器支援的 HTTP 動詞 命令。

WINHTTP_QUERY_AUTHENTICATION_INFO

擷取Authentication-Info標頭。

WINHTTP_QUERY_AUTHORIZATION

擷取用於要求的授權認證。

WINHTTP_QUERY_CACHE_CONTROL

擷取快取控制項指示詞。

WINHTTP_QUERY_CONNECTION

擷取為特定連線指定的任何選項，而且不能由 Proxy 透過進一步連線進行通訊。

WINHTTP_QUERY_CONTENT_BASE

擷取基底統一資源識別項 (URI) ，以解析實體內的相對 URL。

WINHTTP_QUERY_CONTENT_DESCRIPTION

已過時。 維護舊版應用程式相容性。

WINHTTP_QUERY_CONTENT_DISPOSITION

已過時。 維護舊版應用程式相容性。

WINHTTP_QUERY_CONTENT_ENCODING

擷取已套用至整個資源的其他內容程式碼。

WINHTTP_QUERY_CONTENT_ID

擷取內容識別。

WINHTTP_QUERY_CONTENT_LANGUAGE

擷取內容所撰寫的語言。

WINHTTP_QUERY_CONTENT_LENGTH

擷取資源的大小，以位元組為單位。

WINHTTP_QUERY_CONTENT_LOCATION

擷取包含在訊息中之實體的資源位置。

WINHTTP_QUERY_CONTENT_MD5

擷取實體主體的 MD5 摘要，以便提供實體主體的端對端訊息完整性檢查。 如需詳細資訊，請參閱 RFC 1864。

WINHTTP_QUERY_CONTENT_RANGE

擷取完整實體主體中應該插入部分實體主體的位置，以及完整實體主體的總大小。

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

擷取適用于實體主體的編碼轉換。 可能已經套用、可能需要套用，或可能選擇性地適用。

WINHTTP_QUERY_CONTENT_TYPE

接收資源的內容類型，例如文字或 html。

WINHTTP_QUERY_COOKIE

擷取與要求相關聯的任何 Cookie。

WINHTTP_QUERY_COST

不支援。

WINHTTP_QUERY_CUSTOM

導致 WinHttpQueryHeaders 搜尋 pwszName 參數中指定的標頭名稱，並將標頭資訊儲存在 lpBuffer中。 應用程式可以使用 WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT 來限制此查詢等候所有標頭接收的最大時間。

WINHTTP_QUERY_DATE

接收訊息的來源日期和時間。

WINHTTP_QUERY_DERIVED_FROM

不支援。

WINHTTP_QUERY_ETAG

擷取相關聯實體的實體標籤。

WINHTTP_QUERY_EXPECT

擷取 Expect 標頭，指出用戶端應用程式是否應該預期 100 系列回應。

WINHTTP_QUERY_EXPIRES

接收應該將資源視為過期的日期和時間。

WINHTTP_QUERY_FORWARDED

已過時。 維護舊版應用程式相容性。

WINHTTP_QUERY_FROM

如果指定 From 標頭，則擷取控制要求 使用者代理程式之使用者 的電子郵件地址。

WINHTTP_QUERY_HOST

擷取所要求資源的網際網路主機和埠號碼。

WINHTTP_QUERY_IF_MATCH

擷取If-Match要求標頭欄位的內容。

WINHTTP_QUERY_IF_MODIFIED_SINCE

擷取 If-Modified-Since 標頭的內容。

WINHTTP_QUERY_IF_NONE_MATCH

擷取 If-None-Match 要求標頭欄位的內容。

WINHTTP_QUERY_IF_RANGE

擷取If-Range要求標頭欄位的內容。 此標頭可讓用戶端應用程式檢查與用戶端應用程式快取中實體部分複本相關的實體是否已更新。 如果實體尚未更新，請傳送用戶端應用程式遺失的部分。 如果實體已更新，請傳送整個更新的實體。

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

擷取 If-Unmodified-Since request-header 欄位的內容。

WINHTTP_QUERY_LINK

已過時。 維護舊版應用程式相容性。

WINHTTP_QUERY_LAST_MODIFIED

接收上次修改資源的日期和時間。 日期和時間是由伺服器決定。

WINHTTP_QUERY_LOCATION

擷取位置回應標頭中使用的絕對 URI。

WINHTTP_QUERY_MAX

表示WINHTTP_QUERY_* 值的最大值。 不是查詢旗標。

WINHTTP_QUERY_MAX_FORWARDS

擷取可將要求轉送至下一個輸入伺服器的 Proxy 或閘道數目。

WINHTTP_QUERY_MESSAGE_ID

不支援。

WINHTTP_QUERY_MIME_VERSION

接收用來建構訊息的多用途網際網路郵件延伸模組版本 (MIME) 通訊協定。

WINHTTP_QUERY_ORIG_URI

已過時。 維護舊版應用程式相容性。

WINHTTP_QUERY_PRAGMA

接收可能套用至要求/回應鏈結上任何收件者的實作特定指示詞。

WINHTTP_QUERY_PROXY_AUTHENTICATE

擷取 Proxy 傳回的驗證配置和領域。

WINHTTP_QUERY_PROXY_AUTHORIZATION

擷取標頭，這個標頭用來識別需要驗證的 Proxy 使用者。 此標頭只能在要求傳送至伺服器之前擷取。

WINHTTP_QUERY_PROXY_CONNECTION

擷取Proxy-Connection標頭。

WINHTTP_QUERY_PROXY_SUPPORT

擷取Proxy-Support標頭。

WINHTTP_QUERY_PUBLIC

接收此伺服器可用的 HTTP 動詞。

WINHTTP_QUERY_RANGE

擷取實體的位元組範圍。

WINHTTP_QUERY_RAW_HEADERS

接收伺服器傳回的所有標頭。 每個標頭都會由 「\0」 終止。 額外的 「\0」 會終止標頭清單。

WINHTTP_QUERY_RAW_HEADERS_CRLF

接收伺服器傳回的所有標頭。 每個標頭都會以歸位字元/換行字元分隔， (CR/LF) 序列。

WINHTTP_QUERY_REFERER

接收取得要求之 URI 的資源 URI。

WINHTTP_QUERY_REFRESH

已過時。 維護舊版應用程式相容性。

WINHTTP_QUERY_REQUEST_METHOD

接收要求中使用的 HTTP 動詞命令，通常是 GET 或 POST。

WINHTTP_QUERY_RETRY_AFTER

擷取服務預期無法使用的時間量。

WINHTTP_QUERY_SERVER

擷取原始伺服器用來處理要求之軟體的相關資訊。

WINHTTP_QUERY_SET_COOKIE

接收為要求設定的 Cookie 值。

WINHTTP_QUERY_STATUS_CODE

接收伺服器傳回的狀態碼。 如需可能值的清單，請參閱 HTTP 狀態碼。

WINHTTP_QUERY_STATUS_TEXT

接收伺服器在回應行上傳回的其他文字。

WINHTTP_QUERY_TITLE

已過時。 維護舊版應用程式相容性。

WINHTTP_QUERY_TRANSFER_ENCODING

擷取已套用至郵件本文的轉換類型，以便在寄件者和收件者之間安全地傳輸。

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

擷取 Unless-Modified-Since 標頭。

WINHTTP_QUERY_UPGRADE

擷取伺服器所支援的其他通訊協定。

WINHTTP_QUERY_URI

接收可識別 Request-URI 資源的部分或所有 URI。

WINHTTP_QUERY_USER_AGENT

擷取提出要求之使用者代理程式的相關資訊。

WINHTTP_QUERY_VARY

擷取標頭，指出實體已使用伺服器驅動交涉從回應的可用標記法中選取。

WINHTTP_QUERY_VERSION

擷取狀態行中存在的 HTTP 版本。

WINHTTP_QUERY_VIA

擷取使用者代理程式與伺服器上的中繼通訊協定和收件者，以及在源伺服器與用戶端之間擷取回應。

WINHTTP_QUERY_WARNING

擷取回應狀態碼可能不會反映之回應狀態的其他資訊。

WINHTTP_QUERY_WWW_AUTHENTICATE

擷取伺服器傳回的驗證配置和領域。

修飾詞旗標會與屬性旗標搭配使用，以修改要求。 修飾詞旗標會修改傳回的資料格式，或指出 WinHttpQueryHeaders 函式應該搜尋資訊的位置。

WINHTTP_QUERY_FLAG_NUMBER

針對值為數字的標頭，以 32 位數位的形式傳回資料，例如狀態碼。

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

查詢只會要求標頭。

WINHTTP_QUERY_FLAG_SYSTEMTIME

以 SYSTEMTIME 結構的形式傳回標頭值，而不需要應用程式剖析資料。 用於值為日期/時間字串的標頭，例如 「Last-Modified-Time」。

WINHTTP_QUERY_FLAG_TRAILERS

Windows 11 21H2 (10.0 版中引進;組建 22000) 。 查詢回應預告片。 在查詢回應預告片之前，您必須呼叫 WinHttpReadData ，直到傳回 0 個位元組讀取為止。

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Windows 11 21H2 (10.0 版中引進;組建 22000) 。 根據預設， WinHttpQueryHeaders 會先執行 Unicode 轉換，再傳回查詢的標頭。 如果設定此旗標，WinHttp 會將標頭傳回給呼叫端，而不執行此轉換。

規格需求

需求	值
最低支援的用戶端	Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式]
標頭	WinHTTP.h

另請參閱

• WinHTTP 版本