共用方式為


選項旗標 (Wininet.h)

下列選項旗標會與 InternetQueryOptionInternetSetOption 函式搭配使用。 所有有效的選項旗標的值都大於或等於 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,表示應該使用編輯的快取專案而不檢查網路。 InternetQueryOptionInternetSetOption會使用此專案。 它僅適用于 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 控制碼。 InternetQueryOptionInternetSetOption使用。

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 控制碼。 InternetQueryOptionInternetSetOption會使用它。

INTERNET_OPTION_CONNECT_TIME

55

未實作。

INTERNET_OPTION_CONNECT_TIMEOUT

2

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

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

INTERNET_OPTION_CONNECTED_STATE

50

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

INTERNET_OPTION_CONTEXT_VALUE

45

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

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

INTERNET_OPTION_RECEIVE_TIMEOUT相同。 這是由 InternetQueryOptionInternetSetOption使用。

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

INTERNET_OPTION_SEND_TIMEOUT相同。 這是由 InternetQueryOptionInternetSetOption使用。

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

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

此旗標不會影響 HTTP 功能。

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

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

此旗標不會影響 HTTP 功能。

INTERNET_OPTION_DATAFILE_NAME

33

擷取字串值,其中包含備份已下載實體的檔案名。 此旗標在 InternetOpenUrlFtpOpenFileGopherOpenFileHttpOpenRequest 完成之後有效。 此選項只能由 InternetQueryOption查詢。

INTERNET_OPTION_DATAFILE_EXT

96

設定字串值,其中包含備份已下載實體之檔案的副檔名。 呼叫 InternetOpenUrlFtpOpenFileGopherOpenFileHttpOpenRequest之前,應該先設定此旗標。 此選項只能由 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 錯誤碼。 此選項用於InternetQueryOptionNullHINTERNET控制碼上。

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

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

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 控制碼上使用。 InternetQueryOptionInternetSetOption會使用此專案。

在 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 轉換,請在呼叫InternetSetOptionlpBuffer參數中指定INTERNET_FLAG_IDN_DIRECT。 若要只在 Proxy 連線上啟用 IDN 轉換,請在呼叫InternetSetOptionlpBuffer參數中指定INTERNET_FLAG_IDN_PROXY

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

版本: 需要 Internet Explorer 7.0。

INTERNET_OPTION_IGNORE_OFFLINE

77

設定或擷取指定的要求控制碼是否應該忽略全域離線旗標。 這個選項不需要任何緩衝區。 這是由 InternetQueryOptionInternetSetOption 搭配要求控制碼使用。 此選項只在 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 伺服器允許的最大連線數目。 這是由 InternetQueryOptionInternetSetOption使用。 此選項只在 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

設定或擷取不帶正負號的長整數值,其中包含每部伺服器允許的連線數目上限。 這是由 InternetQueryOptionInternetSetOption使用。 此選項只在 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所傳回控制碼相關聯的密碼。 這是由 InternetQueryOptionInternetSetOption使用。

INTERNET_OPTION_PER_CONNECTION_OPTION

75

會設定或擷取指定特定連接之選項清單 的INTERNET_PER_CONN_OPTION_LIST 結構。 這是由 InternetQueryOptionInternetSetOption使用。 此選項只在 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所傳回的控制碼。 它由 InternetQueryOptionInternetSetOption使用。

注意

建議使用INTERNET_OPTION_PER_CONNECTION_OPTION,而不是INTERNET_OPTION_PROXY。

INTERNET_OPTION_PROXY_PASSWORD

44

設定或擷取字串值,其中包含用來存取 Proxy 的密碼。 這是由 InternetQueryOptionInternetSetOption使用。 此選項可以在 InternetConnectHttpOpenRequest傳回的控制碼上設定。

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

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

INTERNET_OPTION_PROXY_USERNAME

43

設定或擷取字串值,其中包含用來存取 Proxy 的使用者名稱。 這是由 InternetQueryOptionInternetSetOption使用。 此選項可以在 InternetConnectHttpOpenRequest傳回的控制碼上設定。

INTERNET_OPTION_READ_BUFFER_SIZE

12

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

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

未實作。

INTERNET_OPTION_RECEIVE_TIMEOUT

6

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

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

當用於 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 控制碼上競爭連線的要求優先順序。 這是由 InternetQueryOptionInternetSetOption使用。

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

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

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

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

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 控制碼。 它由 InternetQueryOptionInternetSetOption使用。

當用於 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_AUTHINTERNET_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_RESETINTERNET_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 不同。 此選項在InternetOpenUrlFtpOpenFileGopherOpenFileHttpOpenRequest所傳回的HINTERNET控制碼上有效。 它由 InternetQueryOption使用。

INTERNET_OPTION_USER_AGENT

41

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

INTERNET_OPTION_USERNAME

28

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

INTERNET_OPTION_VERSION

40

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

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

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

備註

注意

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

規格需求

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