選項旗標 (Wininet.h)

發行項
06/13/2023

下列選項旗標會與 InternetQueryOption 和 InternetSetOption 函式搭配使用。所有有效的選項旗標的值都大於或等於 INTERNET_FIRST_OPTION ，且小於或等於 INTERNET_LAST_OPTION。

INTERNET_OPTION_ALTER_IDENTITY

80
未實作

INTERNET_OPTION_ASYNC

30
未實作。

INTERNET_OPTION_ASYNC_ID

15
未實作。

INTERNET_OPTION_ASYNC_PRIORITY

16
未實作。

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64
設定或擷取布林值，判斷系統是否應該檢查網路是否有較新的內容，並在找到較新版本時覆寫已編輯的快取專案。如果設定為 True，系統會檢查網路是否有較新的內容，並使用較新版本覆寫已編輯的快取專案。預設值為 False，表示應該使用編輯的快取專案而不檢查網路。 InternetQueryOption和InternetSetOption會使用此專案。它僅適用于 Microsoft Internet Explorer 5 和更新版本。

INTERNET_OPTION_CACHE_STREAM_HANDLE

27
不再支援。

INTERNET_OPTION_CACHE_TIMESTAMPS

69
從儲存在網際網路快取中的資源擷取包含 LastModified 時間和到期時間的 INTERNET_CACHE_TIMESTAMPS 結構。 InternetQueryOption會使用此值。

INTERNET_OPTION_CALLBACK

1
設定或擷取為此控制碼定義的回呼函式位址。此選項可用於所有 HINTERNET 控制碼。 InternetQueryOption和InternetSetOption使用。

INTERNET_OPTION_CALLBACK_FILTER

54
未實作。

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84
InternetQueryOption不支援此旗標。 lpBuffer參數必須是CERT_CONTEXT結構的指標，而不是CERT_CONTEXT指標的指標。如果應用程式收到 ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED，它必須呼叫 InternetErrorDlg 或使用 InternetSetOption 來提供憑證，然後再重試要求。接著會呼叫CertDuplicateCertificateCoNtext，讓傳遞的憑證內容可由應用程式獨立發行。

INTERNET_OPTION_CODEPAGE

68
根據預設，Unicode URL 的主機或授權部分會根據 IDN 規格進行編碼。在停用 IDN 時，在要求或連線控制碼上設定此選項，會指定 URL 主機部分的字碼頁編碼配置。呼叫InternetSetOption中的lpBuffer參數包含所需的 DBCS 字碼頁。如果未在 lpBuffer中指定字碼頁，WinINet 會使用預設系統字碼頁 (CP_ACP) 。注意：如果未停用 IDN，則會忽略此選項。如需如何停用 IDN 的詳細資訊，請參閱 INTERNET_OPTION_IDN 選項。

具有 SP2 和 Windows Server 2003 SP1 的 Windows XP： 不支援此旗標。

版本： 需要 Internet Explorer 7.0。

INTERNET_OPTION_CODEPAGE_PATH

100
根據預設，URL 的路徑部分會經過 UTF8 編碼。 WinINet API 會在高位字元上執行逸出字元 (%) 編碼。在要求或連線控制碼上設定此選項會停用 UTF8 編碼，並設定特定的字碼頁。呼叫InternetSetOption中的lpBuffer參數包含路徑所需的 DBCS 字碼頁。如果未在 lpBuffer中指定字碼頁，WinINet 會使用預設CP_UTF8。

具有 SP2 和 Windows Server 2003 SP1 的 Windows XP： 不支援此旗標。

版本： 需要 Internet Explorer 7.0。

INTERNET_OPTION_CODEPAGE_EXTRA

101
根據預設，URL 的路徑部分是預設系統字碼頁 (CP_ACP) 。逸出字元 (%) 轉換不會在額外部分執行。在要求上設定此選項，或連接控制碼會停用CP_ACP編碼。呼叫InternetSetOption中的lpBuffer參數包含 URL 額外部分所需的 DBCS 字碼頁。如果未在 lpBuffer中指定字碼頁，WinINet 會使用預設系統字碼頁 (CP_ACP) 。

具有 SP2 和 Windows Server 2003 SP1 的 Windows XP： 不支援此旗標。

版本： 需要 Internet Explorer 7.0。

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147
針對 WinInet 解壓縮伺服器所提供 Content-Encoding 的要求，會擷取回應本文的伺服器報告內容長度作為 ULONGLONG。 Windows 10 1507 版和更新版本支援。

INTERNET_OPTION_CONNECT_BACKOFF

4
未實作。

INTERNET_OPTION_CONNECT_RETRIES

3
設定或擷取未帶正負號的長整數值，其中包含 WinINet 嘗試解析並聯機到主機的次數。它只會嘗試每個 IP 位址一次。例如，如果您嘗試連線到具有十個 IP 位址且INTERNET_OPTION_CONNECT_RETRIES為 7 的多家主機，WinINet 只會嘗試解析並聯機到前七個 IP 位址。相反地，假設相同的一組十個 IP 位址，如果INTERNET_OPTION_CONNECT_RETRIES設為 20，WinINet 只會嘗試 10 個。如果主機只有一個 IP 位址且第一次連線嘗試失敗，則不會再嘗試。如果連線嘗試在指定的嘗試次數之後仍然失敗，則會取消要求。 INTERNET_OPTION_CONNECT_RETRIES的預設值是五次嘗試。此選項可用於任何 HINTERNET 控制碼，包括 Null 控制碼。 InternetQueryOption和InternetSetOption會使用它。

INTERNET_OPTION_CONNECT_TIME

55
未實作。

INTERNET_OPTION_CONNECT_TIMEOUT

2
設定或擷取未帶正負號的長整數值，其中包含要用於網際網路連線要求的逾時值，以毫秒為單位。將此選項設定為無限 (0xFFFFFFFF) 將會停用此計時器。

如果連線要求花費的時間超過這個逾時值，則會取消要求。嘗試連線到單一主機的多個 IP 位址 (多宿主主機) 時，逾時限制會累積所有 IP 位址。此選項可用於任何 HINTERNET 控制碼，包括 Null 控制碼。它由 InternetQueryOption 和 InternetSetOption使用。

INTERNET_OPTION_CONNECTED_STATE

50
設定或擷取包含連接狀態的不帶正負號長整數值。這是由 InternetQueryOption 和 InternetSetOption使用。

INTERNET_OPTION_CONTEXT_VALUE

45
設定或擷取包含與此 HINTERNET 控制碼相關聯之內容值的位址DWORD_PTR。此選項可用於任何 HINTERNET 控制碼。這是由 InternetQueryOption 和 InternetSetOption使用。之前，這會將內容值設定為儲存在 lpBuffer 指標中的位址。這已修正，因此會使用儲存在緩衝區中的值，並將 INTERNET_OPTION_CONTEXT_VALUE 旗標指派為新的值。舊值 10 已保留，因此仍支援針對舊行為撰寫的應用程式。

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6
與 INTERNET_OPTION_RECEIVE_TIMEOUT相同。這是由 InternetQueryOption 和 InternetSetOption使用。

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5
與 INTERNET_OPTION_SEND_TIMEOUT相同。這是由 InternetQueryOption 和 InternetSetOption使用。

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8
會設定或擷取包含逾時值的不帶正負號長整數值，以毫秒為單位，以接收 FTP 交易之資料通道要求的回應。如果回應花費的時間超過這個逾時值，則會取消要求。此選項可用於任何 HINTERNET 控制碼，包括 Null 控制碼。它由 InternetQueryOption 和 InternetSetOption使用。

此旗標不會影響 HTTP 功能。

INTERNET_OPTION_DATA_SEND_TIMEOUT

7
會設定或擷取不帶正負號的長整數值，以毫秒為單位，其中包含傳送 FTP 交易之資料通道的要求逾時值。如果傳送時間超過此逾時值，則會取消傳送。此選項可用於任何 HINTERNET 控制碼，包括 Null 控制碼。它由 InternetQueryOption 和 InternetSetOption使用。

此旗標不會影響 HTTP 功能。

INTERNET_OPTION_DATAFILE_NAME

33
擷取字串值，其中包含備份已下載實體的檔案名。此旗標在 InternetOpenUrl、 FtpOpenFile、 GopherOpenFile或 HttpOpenRequest 完成之後有效。此選項只能由 InternetQueryOption查詢。

INTERNET_OPTION_DATAFILE_EXT

96
設定字串值，其中包含備份已下載實體之檔案的副檔名。呼叫 InternetOpenUrl、 FtpOpenFile、 GopherOpenFile或 HttpOpenRequest之前，應該先設定此旗標。此選項只能由 InternetSetOption設定。

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67
擷 取包含 指定 HTTP 要求相關資料的INTERNET_DIAGNOSTIC_SOCKET_INFO結構。 InternetQueryOption會使用此旗標。

Windows 7： 不再支援此選項。

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76
讓系統登出摘要式驗證 SSPI 套件，清除為進程建立的所有認證。這個選項不需要任何緩衝區。 InternetSetOption會使用它。

INTERNET_OPTION_DISABLE_AUTODIAL

70
未實作。

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49
未實作。

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148
設定可接受的進階 HTTP 版本的 DWORD 位元遮罩。可以在任何控制碼類型上設定。可能的值包括： HTTP_PROTOCOL_FLAG_HTTP2 (0x2) 。 Windows 10 1507 版和更新版本支援。 無法使用此選項停用舊版 HTTP (1.1 和舊版) 。預設值為 0x0。 Windows 10 1507 版和更新版本支援。

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122
在要求控制碼上，設定布林值，以控制是否要從指定要求的 WinInet 快取傳回重新導向。預設值為 FALSE。 Windows 8和更新版本中支援。

INTERNET_OPTION_ENCODE_EXTRA

155
取得/設定 BOOL，指出查詢字串中的非 ASCII 字元是否應該進行百分比編碼。預設值為 FALSE。 Windows 8.1和更新版本中支援。

INTERNET_OPTION_END_BROWSER_SESSION

42
從硬碟上的密碼快取排清未使用的專案。此外，也會重設同步處理模式每一會話一次時所使用的快取時間。這個選項不需要任何緩衝區。這是 由 InternetSetOption使用。

INTERNET_OPTION_ERROR_MASK

62
設定不帶正負號的長整數值，其中包含可由用戶端應用程式處理的錯誤遮罩。這可以是下列值的組合：

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

表示所有憑證錯誤都會使用相同的錯誤傳回來報告，也就是 ERROR_INTERNET_SEC_CERT_ERRORS。如果已設定此旗標，請在收到ERROR_INTERNET_SEC_CERT_ERRORS錯誤時呼叫InternetErrorDlg，讓使用者可以回應描述問題的熟悉對話方塊。

警告

無法通知使用者此錯誤，會向使用者公開潛在的詐騙攻擊。

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

表示用戶端應用程式可以處理 ERROR_INTERNET_INSERT_CDROM 錯誤碼。

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

表示用戶端應用程式可以處理 ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY 錯誤碼。

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

未實作。

INTERNET_OPTION_ENTERPRISE_CONTEXT

159
設定包含企業識別碼的 PWSTR (請參閱 https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx 適用于要求的) 。 Windows 10 1507 版和更新版本支援。

INTERNET_OPTION_EXTENDED_ERROR

24
擷取未帶正負號的長整數值，其中包含對應至此執行緒內容中最後傳回 之ERROR_INTERNET_ 錯誤訊息的 Winsock 錯誤碼。此選項用於InternetQueryOption的NullHINTERNET控制碼上。

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63
設定或擷取包含系統應該等候回應網路要求的時間長度的 1n 無符號長整數值，然後再檢查快取是否有資源的複本。如果網路要求花費的時間超過指定的時間，而且快取中可以使用所要求的資源，則會從快取擷取資源。 InternetQueryOption和InternetSetOption會使用此專案。

INTERNET_OPTION_HANDLE_TYPE

9
擷取包含傳入之 HINTERNET 控制碼類型的不帶正負號長整數值。這是由 InternetQueryOption 在任何 HINTERNET 控制碼上使用。可能的傳回值包括下列專案。

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157
取得/設定 BOOL，指出 WinInet 是否應遵循來自伺服器的 HTTP 嚴格傳輸安全性 (HSTS) 指示詞。如果啟用，HTTPs:// 由 WinInet 快取 HSTS 原則的網域配置要求，將會重新導向至相符 HTTPs:// URL。預設值為 FALSE。支援Windows 8.1和更新版本。

INTERNET_OPTION_HTTP_DECODING

65
可讓 WinINet 針對 gzip 和 deflate 編碼配置執行解碼。如需詳細資訊，請參閱 內容編碼。

INTERNET_OPTION_HTTP_PROTOCOL_USED

149
取得 DWORD，指出指定要求上使用哪個進階 HTTP 版本。可能的值包括： HTTP_PROTOCOL_FLAG_HTTP2 (0x2) 。支援Windows 10 1507 版和更新版本。 0x0表示 HTTP/1.1 或更早版本;如需使用舊版版本的詳細資訊，請參閱INTERNET_OPTION_HTTP_VERSION。支援Windows 10 1507 版和更新版本。

INTERNET_OPTION_HTTP_VERSION

59
設定或擷取包含支援 HTTP 版本的 HTTP_VERSION_INFO 結構。這必須在 Null 控制碼上使用。 InternetQueryOption和InternetSetOption會使用此專案。

在 Windows 7、Windows Server 2008 R2 和更新版本上，internet Explorer 設定會覆寫HTTP_VERSION_INFO結構中的dwMinorVersion成員值。 EnableHttp1_1 是系統 Internet Explorer 中設定的 Internet Options 所控制的 HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE 下的登錄值。 EnableHttp1_1值預設值為 1。如果 EnableHttp1_1 設定為 1，則會忽略小於 1.1 的任何 HTTP 版本 HTTP_VERSION_INFO 結構。

INTERNET_OPTION_IDENTITY

78
未實作。

INTERNET_OPTION_IDLE_STATE

51
未實作。

INTERNET_OPTION_IDN

102
根據預設，URL 的主機或授權部分會根據直接和 Proxy 連線的 IDN 規格進行編碼。此選項可用於要求，或連線控制碼來啟用或停用 IDN。停用 IDN 時，WinINet 會使用系統字碼頁來編碼 URL 的主機或授權部分。若要停用 IDN 主機轉換，請在呼叫InternetSetOption中將lpBuffer參數設定為零。若要只在直接連線上啟用 IDN 轉換，請在呼叫InternetSetOption的lpBuffer參數中指定INTERNET_FLAG_IDN_DIRECT。若要只在 Proxy 連線上啟用 IDN 轉換，請在呼叫InternetSetOption的lpBuffer參數中指定INTERNET_FLAG_IDN_PROXY。

具有 SP2 和 Windows Server 2003 SP1 的 Windows XP： 不支援此旗標。

版本： 需要 Internet Explorer 7.0。

INTERNET_OPTION_IGNORE_OFFLINE

77
設定或擷取指定的要求控制碼是否應該忽略全域離線旗標。這個選項不需要任何緩衝區。這是由 InternetQueryOption 和 InternetSetOption 搭配要求控制碼使用。此選項只在 Internet Explorer 5 和更新版本中有效。

INTERNET_OPTION_KEEP_CONNECTION

22
未實作。

INTERNET_OPTION_LISTEN_TIMEOUT

11
未實作。

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74
設定或擷取不帶正負號的長整數值，其中包含每個 HTTP/1.0 伺服器允許的最大連線數目。這是由 InternetQueryOption 和 InternetSetOption使用。此選項只在 Internet Explorer 5 和更新版本中有效。

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103
設定或擷取不帶正負號的長整數值，其中包含每個 CERN Proxy 允許的最大連線數目。設定或擷取此選項時， hInternet 參數必須設定為 Null 控制碼值。 Null控制碼值表示應該為目前的進程設定或查詢選項。使用此選項呼叫 InternetSetOption 時，所有現有的 Proxy 物件都會收到新的值。此值限制為 2 到 128 的範圍，包含。

版本： 需要 Internet Explorer 8.0。

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73
設定或擷取不帶正負號的長整數值，其中包含每部伺服器允許的連線數目上限。這是由 InternetQueryOption 和 InternetSetOption使用。此選項只在 Internet Explorer 5 和更新版本中有效。

INTERNET_OPTION_OFFLINE_MODE

26
未實作。

INTERNET_OPTION_OFFLINE_SEMANTICS

52
未實作。

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176
加入宣告弱式簽章 (例如 SHA-1) 視為不安全。這會指示 WinInet 使用CERT_CHAIN_OPT_IN_WEAK_SIGNATURE參數呼叫CertGetCertificateChain。

INTERNET_OPTION_PARENT_HANDLE

21
擷取這個控制碼的父控制碼。此選項可用於InternetQueryOption的任何HINTERNET控制碼。

INTERNET_OPTION_PASSWORD

29
設定或擷取字串值，其中包含與 InternetConnect所傳回控制碼相關聯的密碼。這是由 InternetQueryOption 和 InternetSetOption使用。

INTERNET_OPTION_PER_CONNECTION_OPTION

75
會設定或擷取指定特定連接之選項清單 的INTERNET_PER_CONN_OPTION_LIST 結構。這是由 InternetQueryOption 和 InternetSetOption使用。此選項只在 Internet Explorer 5 和更新版本中有效。

注意

INTERNET_OPTION_PER_CONNECTION_OPTION會導致在呼叫InternetSetOption時使用Null控制碼時，整個系統變更設定。若要重新整理全域 Proxy 設定，您必須使用INTERNET_OPTION_REFRESH選項旗標呼叫InternetSetOption。

注意

若要變更整個程式的 Proxy 資訊，而不會影響 Internet Explorer 5 和更新版本中的全域設定，請在從 InternetOpen傳回的控制碼上使用此選項。下列程式碼範例會變更整個進程的 Proxy，即使 HINTERNET 控制碼已關閉，也不會由任何要求使用。

INTERNET_OPTION_POLICY

48
未實作。

INTERNET_OPTION_PROXY

38
設定或擷取包含現有 InternetOpen 控制碼 Proxy 資料的INTERNET_PROXY_INFO結構，當 HINTERNET 控制碼不是 Null時。如果 HINTERNET 控制碼為 Null，函式會設定或查詢全域 Proxy 資料。此選項可用於 InternetOpen所傳回的控制碼。它由 InternetQueryOption 和 InternetSetOption使用。

注意

建議使用INTERNET_OPTION_PER_CONNECTION_OPTION，而不是INTERNET_OPTION_PROXY。

INTERNET_OPTION_PROXY_PASSWORD

44
設定或擷取字串值，其中包含用來存取 Proxy 的密碼。這是由 InternetQueryOption 和 InternetSetOption使用。此選項可以在 InternetConnect 或 HttpOpenRequest傳回的控制碼上設定。

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95
警示目前的 WinInet 實例，Proxy 設定已變更，且必須以新的設定進行更新。若要警示所有可用的 WinInet 實例，請在傳遞此選項時，將InternetSetOption的Buffer參數設定為Null，並將BufferLength設定為 0。此選項可以在 InternetConnect 或 HttpOpenRequest傳回的控制碼上設定。

INTERNET_OPTION_PROXY_USERNAME

43
設定或擷取字串值，其中包含用來存取 Proxy 的使用者名稱。這是由 InternetQueryOption 和 InternetSetOption使用。此選項可以在 InternetConnect 或 HttpOpenRequest傳回的控制碼上設定。

INTERNET_OPTION_READ_BUFFER_SIZE

12
設定或擷取包含讀取緩衝區大小的不帶正負號長整數值。此選項只能在FTPOpenFile、FtpFindFirstFile和InternetConnect (FTP 會話) 傳回的HINTERNET控制碼上使用。 InternetQueryOption和InternetSetOption會使用此選項。

INTERNET_OPTION_RECEIVE_THROUGHPUT

57
未實作。

INTERNET_OPTION_RECEIVE_TIMEOUT

6
會設定或擷取包含逾時值的不帶正負號長整數值，以毫秒為單位，以接收要求的回應。如果回應花費的時間超過這個逾時值，則會取消要求。此選項可用於任何 HINTERNET 控制碼，包括 Null 控制碼。它由 InternetQueryOption 和 InternetSetOption使用。

此選項並非用來代表更精細的立即逾時。您可以在設定逾時值之後，預期逾時最多會發生六秒。

當用於 FTP 交易的參考時，此選項會參考控制通道。

INTERNET_OPTION_REFRESH

37
導致從登錄重新讀取控制碼的 Proxy 資料。不需要緩衝區。此選項可用於InternetOpen所傳回的HINTERNET控制碼。 InternetSetOption會使用它。

INTERNET_OPTION_REMOVE_IDENTITY

79
未實作。

INTERNET_OPTION_REQUEST_FLAGS

23
擷取不帶正負號的長整數值，其中包含指出下載進行中狀態的特殊狀態旗標。這是 由 InternetQueryOption使用。 INTERNET_OPTION_REQUEST_FLAGS選項可以是下列其中一個值：

INTERNET_REQFLAG_ASYNC

0x00000002

未實作。

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

無法 (HTTPS 要求快取網際網路要求，例如) 。

INTERNET_REQFLAG_FROM_CACHE

0x00000001

回應來自快取。

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

網際網路要求逾時。

INTERNET_REQFLAG_NO_HEADERS

0x00000008

原始回應未包含標頭。

INTERNET_REQFLAG_PASSIVE

0x00000010

未實作。

INTERNET_REQFLAG_VIA_PROXY

0x00000004

已透過 Proxy 提出要求。

INTERNET_OPTION_REQUEST_PRIORITY

58
設定或擷取不帶正負號的長整數值，其中包含在 HTTP 控制碼上競爭連線的要求優先順序。這是由 InternetQueryOption 和 InternetSetOption使用。

INTERNET_OPTION_RESET_URLCACHE_SESSION

60
啟動進程的新快取會話。不需要緩衝區。這是 由 InternetSetOption使用。此選項僅保留供內部使用。

INTERNET_OPTION_SECONDARY_CACHE_KEY

53
設定或擷取包含次要快取索引鍵的字串值。這是由 InternetQueryOption 和 InternetSetOption使用。此選項僅保留供內部使用。

INTERNET_OPTION_SECURITY_CERTIFICATE

35
將 SSL/PCT (安全通訊端層/私人通訊技術) 伺服器的憑證擷取為格式化字串。這是 由 InternetQueryOption使用。

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32
將 SSL/PCT 伺服器的憑證擷取到INTERNET_CERTIFICATE_INFO結構中。這是 由 InternetQueryOption使用。

INTERNET_OPTION_SECURITY_FLAGS

31
擷取不帶正負號的長整數值，其中包含控制碼的安全性旗標。 InternetQueryOption會使用此選項。它可以是下列值的組合。

SECURITY_FLAG_128BIT

0x20000000

與慣用值相同SECURITY_FLAG_STRENGTH_STRONG。這只會在 對 InternetQueryOption的呼叫中傳回。

SECURITY_FLAG_40BIT

0x10000000

與慣用值相同SECURITY_FLAG_STRENGTH_WEAK。這只會在 對 InternetQueryOption的呼叫中傳回。

SECURITY_FLAG_56BIT

0x40000000

與慣用值相同SECURITY_FLAG_STRENGTH_MEDIUM。這只會在 對 InternetQueryOption的呼叫中傳回。

SECURITY_FLAG_FORTEZZA

0x08000000

表示已使用 Fortezza 為指定的連線提供密碼、驗證和/或完整性。

SECURITY_FLAG_IETFSSL4

0x00000020

未實作。

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

忽略 ERROR_INTERNET_SEC_CERT_CN_INVALID 錯誤訊息。

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

忽略 ERROR_INTERNET_SEC_CERT_DATE_INVALID 錯誤訊息。

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

忽略 ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR 錯誤訊息。

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

忽略 ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR 錯誤訊息。

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

忽略憑證撤銷問題。

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

忽略未知的憑證授權單位單位問題。

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

忽略弱式憑證簽章問題。

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

忽略不正確的使用問題。

SECURITY_FLAG_NORMALBITNESS

0x10000000

與值 SECURITY_FLAG_STRENGTH_WEAK相同。這只會在 對 InternetQueryOption的呼叫中傳回。

SECURITY_FLAG_PCT

0x00000008

未實作。

SECURITY_FLAG_PCT4

0x00000010

未實作。

SECURITY_FLAG_SECURE

0x00000001

使用安全傳輸。這只會在 對 InternetQueryOption的呼叫中傳回。

SECURITY_FLAG_SSL

0x00000002

未實作。

SECURITY_FLAG_SSL3

0x00000004

未實作。

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

使用中 (56 位) 加密。這只會在 對 InternetQueryOption的呼叫中傳回。

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

使用強 (128 位) 加密。這只會在 對 InternetQueryOption的呼叫中傳回。

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

使用弱式 (40 位) 加密。這只會在 對 InternetQueryOption的呼叫中傳回。

SECURITY_FLAG_UNKNOWNBIT

0x80000000

加密中使用的位大小未知。這只會在 對 InternetQueryOption的呼叫中傳回。

請注意，以這種方式擷取的資料與已發生的交易有關，其安全性層級無法再變更。

INTERNET_OPTION_SECURITY_KEY_BITNESS

36
擷取不帶正負號的長整數值，其中包含加密金鑰的位大小。數位愈大，使用的加密強度就越大。這是 由 InternetQueryOption使用。請注意，以這種方式擷取的資料與已發生的交易有關，其安全性層級無法再變更。

INTERNET_OPTION_SEND_THROUGHPUT

56
未實作。

INTERNET_OPTION_SEND_TIMEOUT

5
設定或擷取不帶正負號的長整數值，以毫秒為單位，其中包含傳送要求的逾時值。如果傳送時間超過此逾時值，則會取消傳送。此選項可用於任何 HINTERNET 控制碼，包括 Null 控制碼。它由 InternetQueryOption 和 InternetSetOption使用。

當用於 FTP 交易的參考時，此選項會參考控制通道。

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105
擷取伺服器憑證鏈內容做為重複的PCCERT_CHAIN_CONTEXT。您可以將此重複的內容傳遞至任何採用 PCCERT_CHAIN_CONTEXT的密碼編譯 API 函式。當您完成憑證鏈結內容時，必須在傳回PCCERT_CHAIN_CONTEXT上呼叫CertFreeCertificateChain。

版本： 需要 Internet Explorer 8.0。

INTERNET_OPTION_SETTINGS_CHANGED

39
通知系統登錄設定已變更，讓它在下一次呼叫 InternetConnect時驗證設定。這是 由 InternetSetOption使用。

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104
設定 HTTP 要求物件，使其不會登入源伺服器，但會執行自動登入 HTTP Proxy 伺服器。此選項與要求旗 標INTERNET_FLAG_NO_AUTH不同，這可防止 Proxy 伺服器和源伺服器進行驗證。

設定此模式將會在與源伺服器通訊時，隱藏先前提供的使用者名稱/密碼或用戶端 SSL 憑證) 使用任何認證 (資料。不過，如果要求必須透過驗證 Proxy 傳輸，WinINet 仍會根據使用者的內部網路區域設定，對 HTTP Proxy 執行自動驗證。預設的內部網路區域設定是允許使用使用者的預設認證自動登入。

為了確保隱藏所有識別資訊，呼叫端應該結合 INTERNET_OPTION_SUPPRESS_SERVER_AUTH 與 INTERNET_FLAG_NO_COOKIES 要求旗標。

只有在傳送要求物件之前，才能設定此選項。在傳送要求之後嘗試設定此選項，將會傳回 ERROR_INTERNET_INCORRECT_HANDLE_STATE。

這個選項不需要任何緩衝區。 InternetSetOption只會在HttpOpenRequest所傳回的控制碼上使用。

版本： 需要 Internet Explorer 8.0 或更新版本。

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81
一般用途選項，用來隱藏整個進程的行為。函式的 lpBuffer 參數必須是 DWORD 的指標，其中包含要隱藏的特定行為。無法使用 InternetQueryOption查詢此選項。允許的值如下：

INTERNET_SUPPRESS_RESET_ALL

0

停用所有隱藏、重新啟用預設和設定的行為。此選項相當於個別設定 INTERNET_SUPPRESS_COOKIE_POLICY_RESET 和 INTERNET_SUPPRESS_COOKIE_PERSIST_RESET 。

版本： 需要 Internet Explorer 6.0 或更新版本。

INTERNET_SUPPRESS_COOKIE_POLICY

1

忽略任何已設定的 Cookie 原則，並允許設定 Cookie。

版本： 需要 Internet Explorer 6.0 或更新版本。

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

停用 INTERNET_SUPPRESS_COOKIE_POLICY 歸併，允許根據設定的 Cookie 原則評估 Cookie。

版本： 需要 Internet Explorer 6.0 或更新版本。

INTERNET_SUPPRESS_COOKIE_PERSIST

3

即使伺服器已將其指定為持續性，仍會隱藏 Cookie 的持續性。

版本： 需要 Internet Explorer 8.0 或更新版本。

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

停用 INTERNET_SUPPRESS_COOKIE_PERSIST 歸併，重新啟用 Cookie 的持續性。任何先前隱藏的 Cookie 都不會變成持續性。

版本： 需要 Internet Explorer 8.0 或更新版本。

INTERNET_OPTION_URL

34
擷取包含已下載資源完整 URL 的字串值。如果原始 URL 包含任何額外的資料，例如搜尋字串或錨點，或重新導向呼叫，則傳回的 URL 與原始 URL 不同。此選項在InternetOpenUrl、FtpOpenFile、GopherOpenFile或HttpOpenRequest所傳回的HINTERNET控制碼上有效。它由 InternetQueryOption使用。

INTERNET_OPTION_USER_AGENT

41
設定或擷取 InternetOpen 所提供的控制碼上的使用者代理程式字串，並在後續 HttpSendRequest 函式中使用，只要 HttpAddRequestHeaders 或 HttpSendRequest新增的標頭不會覆寫它。這是由 InternetQueryOption 和 InternetSetOption使用。

INTERNET_OPTION_USERNAME

28
設定或擷取字串，其中包含與 InternetConnect所傳回控制碼相關聯的使用者名稱。這是由 InternetQueryOption 和 InternetSetOption使用。

INTERNET_OPTION_VERSION

40
擷取包含Wininet.dll版本號碼的 INTERNET_VERSION_INFO 結構。此選項可用於InternetQueryOption的NullHINTERNET控制碼。

INTERNET_OPTION_WRITE_BUFFER_SIZE

13
設定或擷取不帶正負號的長整數值，其中包含寫入緩衝區的大小，以位元組為單位。此選項只能用於FtpOpenFile和InternetConnect (FTP 會話所傳回的HINTERNET控制碼) 。它由 InternetQueryOption 和 InternetSetOption使用。

備註

注意

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

規格需求

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

共用方式為

選項旗標 (Wininet.h)

備註

規格需求

意見反應

其他資源