查詢資訊旗標 (Wininet.h)

下列清單包含 HttpQueryInfo 和 QueryInfo所使用的屬性和修飾詞。

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

HTTP_QUERY_ACCEPT

24

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

HTTP_QUERY_ACCEPT_CHARSET

25

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

HTTP_QUERY_ACCEPT_ENCODING

26

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

HTTP_QUERY_ACCEPT_LANGUAGE

27

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

HTTP_QUERY_ACCEPT_RANGES

42

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

HTTP_QUERY_AGE

48

擷取 Age response-header 欄位，其中包含寄件者在源伺服器上產生回應以來所估計的時間量。

HTTP_QUERY_ALLOW

7

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

HTTP_QUERY_AUTHORIZATION

28

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

HTTP_QUERY_CACHE_CONTROL

49

擷取快取控制項指示詞。

HTTP_QUERY_CONNECTION

23

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

HTTP_QUERY_CONTENT_BASE

50

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

HTTP_QUERY_CONTENT_DESCRIPTION

4

已過時。 僅針對舊版應用程式相容性進行維護。

HTTP_QUERY_CONTENT_DISPOSITION

47

已過時。 僅針對舊版應用程式相容性進行維護。

HTTP_QUERY_CONTENT_ENCODING

29

擷取已套用至整個資源的任何其他內容編碼。

HTTP_QUERY_CONTENT_ID

3

擷取內容識別。

HTTP_QUERY_CONTENT_LANGUAGE

6

擷取內容所在的語言。

HTTP_QUERY_CONTENT_LENGTH

5

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

HTTP_QUERY_CONTENT_LOCATION

51

擷取訊息中所括實體的資源位置。

HTTP_QUERY_CONTENT_MD5

52

擷取實體主體的 MD5 摘要，以便提供實體主體的端對端訊息完整性檢查 (MIC) 。 如需詳細資訊，請參閱 的 https://ftp.isi.edu/in-notes/rfc1864.txt RFC1864、Content-MD5 標頭欄位。

HTTP_QUERY_CONTENT_RANGE

53

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

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2

接收已套用至資源的其他內容編碼。

HTTP_QUERY_CONTENT_TYPE

1

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

HTTP_QUERY_COOKIE

44

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

HTTP_QUERY_COST

15

不再支援。

HTTP_QUERY_CUSTOM

65535

導致 HttpQueryInfo 搜尋 lpvBuffer 中指定的標頭名稱，並將標頭資料儲存在 lpvBuffer中。

HTTP_QUERY_DATE

9

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

HTTP_QUERY_DERIVED_FROM

14

不再支援。

HTTP_QUERY_ECHO_HEADERS

73

目前未實作。

HTTP_QUERY_ECHO_HEADERS_CRLF

74

目前未實作。

HTTP_QUERY_ECHO_REPLY

72

目前未實作。

HTTP_QUERY_ECHO_REQUEST

71

目前未實作。

HTTP_QUERY_ETAG

54

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

HTTP_QUERY_EXPECT

68

擷取 [預期] 標頭，指出用戶端應用程式是否應該預期 100 個數列回應。

HTTP_QUERY_EXPIRES

10

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

HTTP_QUERY_FORWARDED

30

已過時。 僅針對舊版應用程式相容性進行維護。

HTTP_QUERY_FROM

31

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

HTTP_QUERY_HOST

55

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

HTTP_QUERY_IF_MATCH

56

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

HTTP_QUERY_IF_MODIFIED_SINCE

32

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

HTTP_QUERY_IF_NONE_MATCH

57

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

HTTP_QUERY_IF_RANGE

58

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

HTTP_QUERY_IF_UNMODIFIED_SINCE

59

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

HTTP_QUERY_LAST_MODIFIED

11

接收伺服器認為資源上次修改的日期和時間。

HTTP_QUERY_LINK

16

已過時。 僅針對舊版應用程式相容性進行維護。

HTTP_QUERY_LOCATION

33

擷取位置回應標頭中使用的絕對統一資源識別項 (URI) 。

HTTP_QUERY_MAX

78

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

HTTP_QUERY_MAX_FORWARDS

60

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

HTTP_QUERY_MESSAGE_ID

12

不再支援。

HTTP_QUERY_MIME_VERSION

0

接收用來建構訊息的 MIME 通訊協定版本。

HTTP_QUERY_ORIG_URI

34

已過時。 僅針對舊版應用程式相容性進行維護。

HTTP_QUERY_PRAGMA

17

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

HTTP_QUERY_PROXY_AUTHENTICATE

41

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

HTTP_QUERY_PROXY_AUTHORIZATION

61

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

HTTP_QUERY_PROXY_CONNECTION

69

擷取 Proxy-Connection 標頭。

HTTP_QUERY_PUBLIC

8

接收此伺服器可用的方法。

HTTP_QUERY_RANGE

62

擷取實體的位元組範圍。

HTTP_QUERY_RAW_HEADERS

21

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

HTTP_QUERY_RAW_HEADERS_CRLF

22

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

HTTP_QUERY_REFERER

35

接收取得所要求 URI 之資源的統一資源識別項 (URI) 。

HTTP_QUERY_REFRESH

46

已過時。 僅針對舊版應用程式相容性進行維護。

HTTP_QUERY_REQUEST_METHOD

45

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

HTTP_QUERY_RETRY_AFTER

36

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

HTTP_QUERY_SERVER

37

擷取源伺服器用來處理要求之軟體的相關資料。

HTTP_QUERY_SET_COOKIE

43

接收為要求設定的 Cookie 值。

HTTP_QUERY_STATUS_CODE

19

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

HTTP_QUERY_STATUS_TEXT

20

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

HTTP_QUERY_TITLE

38

已過時。 僅針對舊版應用程式相容性進行維護。

HTTP_QUERY_TRANSFER_ENCODING

63

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

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70

擷取 [除非修改後-自] 標頭。

HTTP_QUERY_UPGRADE

64

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

HTTP_QUERY_URI

13

接收一些或所有統一資源識別項 (URI) ，以便識別 Request-URI 資源。

HTTP_QUERY_USER_AGENT

39

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

HTTP_QUERY_VARY

65

擷取標頭，這個標頭表示實體是使用伺服器驅動交涉從回應的多個可用標記法中選取的。

HTTP_QUERY_VERSION

18

接收伺服器傳回的最後一個回應碼。

HTTP_QUERY_VIA

66

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

HTTP_QUERY_WARNING

67

擷取回應狀態碼可能未反映之回應狀態的其他資料。

HTTP_QUERY_WWW_AUTHENTICATE

40

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

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79

擷取 X-Content-Type-Options 標頭值。

HTTP_QUERY_P3P

80

擷取 P3P 標頭值。

HTTP_QUERY_X_P2P_PEERDIST

81

擷取 X-P2P-PeerDist 標頭值。

HTTP_QUERY_TRANSLATE

82

擷取翻譯標頭值。

HTTP_QUERY_X_UA_COMPATIBLE

83

擷取 X-UA-Compatible 標頭值。

HTTP_QUERY_DEFAULT_STYLE

84

擷取 Default-Style 標頭值。

HTTP_QUERY_X_FRAME_OPTIONS

85

擷取 X-Frame-Options 標頭值。

HTTP_QUERY_X_XSS_PROTECTION

86

擷取 X-XSS-Protection 標頭值。

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

HTTP_QUERY_FLAG_COALESCE

0x10000000

未實作。

HTTP_QUERY_FLAG_NUMBER

0x20000000

傳回資料做為 32 位數位，其值為數字的標頭，例如狀態碼。

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000

僅查詢要求標頭。

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000

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

備註

注意

WinINet 不支援伺服器實作。 此外，它不應該從服務使用。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。

規格需求

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