iXMLHTTPRequest2：：SetProperty 方法 (msxml6.h)

在傳出 HTTP 要求上設定屬性。

語法

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

[in] eProperty

下列是有效值：

值	意義
XHR_PROP_NO_CRED_PROMPT	隱藏使用者認證的自動提示
XHR_PROP_NO_AUTH	隱藏 HTTP 堆疊代表應用程式執行的驗證
XHR_PROP_TIMEOUT	將所有逾時值設定為 ullValue 指定的值，以毫秒為單位。
XHR_PROP_NO_DEFAULT_HEADERS	隱藏將預設標頭新增至 HTTP 要求。
XHR_PROP_REPORT_REDIRECT_STATUS	讓 HTTP 堆疊使用過渡性重新導向狀態代碼呼叫 OnHeadersAvailable 方法。系統會再次呼叫 OnHeadersAvailable 方法，以取得其他重新導向和最終目的地狀態代碼。
XHR_PROP_NO_CACHE	隱藏 HTTP 要求的快取讀取和寫入。 IXMLHTTPRequest3 介面支援這個屬性。
XHR_PROP_EXTENDED_ERROR	導致 HTTP 堆疊在發生失敗時，將基礎 Win32 錯誤碼提供給 OnError 方法的 HRESULTS。 IXMLHTTPRequest3 介面支援這個屬性。
XHR_PROP_QUERY_STRING_UTF8	導致查詢字串在UTF-8中編碼，而不是 HTTP 要求的 ACP。 IXMLHTTPRequest3 介面支援這個屬性。
XHR_PROP_IGNORE_CERT_ERRORS	隱藏某些憑證錯誤。 IXMLHTTPRequest3 介面支援這個屬性。

[in] ullValue

指定應用程式在逾時前等候的毫秒數。

值	意義
XHR_PROP_NO_CRED_PROMPT	此參數可以是 Msxml6.h 頭檔中所定義XHR_CRED_PROMPT列舉類型的其中一個值。 XHR_CRED_PROMPT_ALL 是否應啟用認證提示， (預設) 。 XHR_CRED_PROMPT_NONE 是否應停用認證提示。 XHR_CRED_PROMPT_PROXY 是否應該只啟用 Proxy 驗證的認證提示。
XHR_PROP_NO_AUTH	這個參數可以是 msxml6.h 頭檔中所定義XHR_AUTH列舉類型的其中一個值。 XHR_AUTH_ALL 如果啟用驗證， (預設) 。如果停用驗證，XHR_AUTH_NONE。 XHR_AUTH_PROXY 只應該啟用 Proxy 驗證的驗證。
XHR_PROP_TIMEOUT	應用程式在逾時之前等候的毫秒數，最多0xFFFFFFFF。
XHR_PROP_NO_DEFAULT_HEADERS	FALSE (0x0) 啟用新增預設標頭 (預設) 。 TRUE (0x1) 停用新增預設標頭。
XHR_PROP_REPORT_REDIRECT_STATUS	FALSE (0x0) 未回報重新導向狀態， (預設) 。 TRUE (0x1) 報告重新導向狀態。
XHR_PROP_NO_CACHE	FALSE (0x0) 啟用 (預設) 快取。 TRUE (0x1) 停用快取。
XHR_PROP_EXTENDED_ERROR	FALSE (0x0) 不提供預設) 的擴充錯誤 (。 TRUE (0x1) 提供擴充錯誤。
XHR_PROP_QUERY_STRING_UTF8	FALSE (0x0) 未在 UTF-8 中編碼查詢字串， (預設) 。 TRUE (0x1) 以 UTF-8 編碼查詢字串。
XHR_PROP_IGNORE_CERT_ERRORS	FALSE (0x0) 不會忽略預設) (憑證錯誤。 TRUE (0x1) 忽略憑證錯誤。

傳回成功時的 S_OK 。

IXMLHTTPRequest2 介面上的 SetProperty 方法會在 IXMLHTTPRequest3 介面上延伸，並具有新的屬性來支援新的案例：

XHR_PROP_NO_CACHE – 隱藏 HTTP 要求的快取讀取和寫入。
XHR_PROP_EXTENDED_ERROR – 導致 HTTP 堆疊在發生失敗時，將基礎 Win32 錯誤碼提供給 OnError 方法的 HRESULTS。
XHR_PROP_QUERY_STRING_UTF8 – 導致查詢字串以 UTF-8 編碼，而不是使用 ACP 進行 HTTP 要求。
XHR_PROP_IGNORE_CERT_ERRORS – 隱藏某些伺服器證書錯誤。

需求	值
最低支援的用戶端	Windows 8 [傳統型應用程式 \|UWP 應用程式]，MSXML 6.0 和更新版本
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	msxml6.h