WinHttpRequestOption 列舉

WinHttpRequestOption 列舉包含可針對目前 Microsoft windows HTTP 服務（WinHTTP）會話設定或擷取的選項。

語法

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 用戶端停滯。