WinHttpRequestOption 列舉

發行項
06/03/2023

WinHttpRequestOption列舉包含可針對目前 Microsoft Windows HTTP 服務設定或擷取的選項， (WinHTTP) 會話。

Syntax

typedef enum WinHttpRequestOption { 
  WinHttpRequestOption_UserAgentString,
  WinHttpRequestOption_URL,
  WinHttpRequestOption_URLCodePage,
  WinHttpRequestOption_EscapePercentInURL,
  WinHttpRequestOption_SslErrorIgnoreFlags,
  WinHttpRequestOption_SelectCertificate,
  WinHttpRequestOption_EnableRedirects,
  WinHttpRequestOption_UrlEscapeDisable,
  WinHttpRequestOption_UrlEscapeDisableQuery,
  WinHttpRequestOption_SecureProtocols,
  WinHttpRequestOption_EnableTracing,
  WinHttpRequestOption_RevertImpersonationOverSsl,
  WinHttpRequestOption_EnableHttpsToHttpRedirects,
  WinHttpRequestOption_EnablePassportAuthentication,
  WinHttpRequestOption_MaxAutomaticRedirects,
  WinHttpRequestOption_MaxResponseHeaderSize,
  WinHttpRequestOption_MaxResponseDrainSize,
  WinHttpRequestOption_EnableHttp1_1,
  WinHttpRequestOption_EnableCertificateRevocationCheck
} WinHttpRequestOption;

常數

WinHttpRequestOption_UserAgentString

設定或擷取包含使用者代理程式字串的VARIANT。

WinHttpRequestOption_URL

擷取包含資源 URL 的 VARIANT 。這個值是唯讀的;您無法使用這個屬性來設定 URL。在呼叫 Open 方法之前，無法讀取 URL。此選項適用于在 Send 方法完成之後檢查 URL，以確認發生任何重新導向。

WinHttpRequestOption_URLCodePage

設定或擷取 VARIANT ，識別 URL 字串的代碼頁。預設值為 UTF-8 字碼頁。字碼頁可用來將 Open 方法中傳遞的 Unicode URL 字串轉換成單一位元組字串表示。

WinHttpRequestOption_EscapePercentInURL

設定或擷取 VARIANT ，指出 URL 字串中的百分比字元是否轉換成逸出序列。此選項的預設值 是VARIANT_TRUE ，它會指定所有不安全的美國標準局 (ANSI) 字元，但百分比符號會轉換成逸出序列。

WinHttpRequestOption_SslErrorIgnoreFlags

設定或擷取 VARIANT ，指出應該忽略哪一個伺服器憑證錯誤。這可以是下列一或多個旗標的組合。

錯誤	值
未知的憑證授權單位單位 (CA) 或未受信任的根目錄	0x0100
使用錯誤	0x0200
不正確一般名稱 (CN)	0x1000
不正確日期或憑證已過期	0x2000

WinHTTP 5.1 版中這個選項的預設值為零，因此不會忽略任何錯誤。在舊版 WinHTTP 中，預設設定是0x3300，因此預設會忽略所有伺服器憑證錯誤。

WinHttpRequestOption_SelectCertificate

設定 VARIANT ，指定傳送至伺服器以進行驗證的用戶端憑證。此選項表示以反斜線分隔之用戶端憑證的位置、 憑證存放區和主體。如需選取用戶端憑證的詳細資訊，請參閱 WinHTTP 中的 SSL。

WinHttpRequestOption_EnableRedirects

設定或擷取 VARIANT ，指出當伺服器指定資源的新位置時，是否會自動重新導向要求。此選項的預設值 是VARIANT_TRUE ，表示要求會自動重新導向。

WinHttpRequestOption_UrlEscapeDisable

設定或擷取 VARIANT ，指出 URL 路徑和查詢元件中的不安全字元是否會轉換成逸出序列。這個選項的預設值是 VARIANT_TRUE，指定路徑和查詢中的字元會轉換。

WinHttpRequestOption_UrlEscapeDisableQuery

設定或擷取 VARIANT ，指出 URL 查詢元件中的不安全字元是否會轉換成逸出序列。這個選項的預設值是 VARIANT_TRUE，指定查詢中的字元會轉換。

WinHttpRequestOption_SecureProtocols

設定或擷取 VARIANT ，指出可以使用哪些安全通訊協定。此選項會選取用戶端可接受的通訊協定。通訊協定會在安全通訊端層 (SSL) 交握期間交涉。這可以是下列一或多個旗標的組合。

通訊協定	值
SSL 2.0	0x0008
SSL 3.0	0x0020
傳輸層安全性 (TLS) 1.0	0x0080

此選項的預設值是0x0028，表示可以使用 SSL 2.0 或 SSL 3.0。如果此選項設定為零，則用戶端和伺服器無法判斷可接受的安全性通訊協定，而下一個傳送會導致錯誤。

WinHttpRequestOption_EnableTracing

設定或擷取 VARIANT ，指出追蹤目前是否已啟用。另請參閱收集 WinHTTP 追蹤。

WinHttpRequestOption_RevertImpersonationOverSsl

控制 WinHttpRequest 物件是否在 SSL 憑證驗證作業期間暫時還原用戶端模擬。 WinHttpRequest物件的預設設定為TRUE。將此選項設定為 FALSE ，以在執行憑證驗證作業時保留模擬。

WinHttpRequestOption_EnableHttpsToHttpRedirects

控制 WinHTTP 是否允許重新導向。根據預設，系統會自動遵循所有重新導向，但從安全 (HTTPs) URL 傳輸至不安全 (HTTP) URL 的重新導向除外。將此選項設定為 TRUE ，以啟用 HTTPS 至 HTTP 重新導向。

WinHttpRequestOption_EnablePassportAuthentication

啟用或停用 Passport 驗證的支援。根據預設，會停用 Passport 驗證的自動支援;將此選項設定為 TRUE 以啟用 Passport 驗證支援。

WinHttpRequestOption_MaxAutomaticRedirects

設定或擷取 WinHTTP 所遵循的重新導向數目上限;預設值為 10。此限制可防止未經授權的網站在大量重新導向之後停止 WinHTTP 用戶端。