共用方式為


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

另請參閱

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

開啟

XHR_PROPERTY列舉