Bagikan melalui


Metode IXMLHTTPRequest2::SetProperty (msxml6.h)

Mengatur properti pada permintaan HTTP keluar.

Sintaks

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

Parameter

[in] eProperty

Berikut adalah nilai yang valid:

Nilai Makna
XHR_PROP_NO_CRED_PROMPT
Menekan permintaan otomatis untuk kredensial pengguna
XHR_PROP_NO_AUTH
Menekan autentikasi yang dilakukan tumpukan HTTP atas nama aplikasi
XHR_PROP_TIMEOUT
Mengatur semua nilai batas waktu ke nilai yang diberikan oleh ullValue, dalam milidetik.
XHR_PROP_NO_DEFAULT_HEADERS
Menekan penambahan header default ke permintaan HTTP.
XHR_PROP_REPORT_REDIRECT_STATUS
Menyebabkan tumpukan HTTP memanggil metode OnHeadersAvailable dengan kode status pengalihan sementara. Metode OnHeadersAvailable akan dipanggil lagi untuk pengalihan tambahan dan kode status tujuan akhir.
XHR_PROP_NO_CACHE
Menekan pembacaan dan penulisan cache untuk permintaan HTTP.

Properti ini didukung oleh antarmuka IXMLHTTPRequest3 .

XHR_PROP_EXTENDED_ERROR
Menyebabkan tumpukan HTTP menyediakan HRESULTS dengan kode kesalahan Win32 yang mendasar ke metode OnError jika terjadi kegagalan.

Properti ini didukung oleh antarmuka IXMLHTTPRequest3 .

XHR_PROP_QUERY_STRING_UTF8
Menyebabkan string kueri dikodekan di UTF-8 alih-alih ACP untuk permintaan HTTP.

Properti ini didukung oleh antarmuka IXMLHTTPRequest3 .

XHR_PROP_IGNORE_CERT_ERRORS
Menekan kesalahan sertifikat tertentu.

Properti ini didukung oleh antarmuka IXMLHTTPRequest3 .

[in] ullValue

Menentukan jumlah milidetik yang ditunggu aplikasi sebelum waktu habis.

Nilai Makna
XHR_PROP_NO_CRED_PROMPT
Parameter ini dapat menjadi salah satu nilai dari jenis enumerasi XHR_CRED_PROMPT yang ditentukan dalam file header Msxml6.h .
  • XHR_CRED_PROMPT_ALL apakah permintaan kredensial harus diaktifkan (default).
  • XHR_CRED_PROMPT_NONE jika permintaan kredensial harus dinonaktifkan.
  • XHR_CRED_PROMPT_PROXY jika permintaan kredensial hanya boleh diaktifkan untuk autentikasi proksi.
XHR_PROP_NO_AUTH
Parameter ini dapat menjadi salah satu nilai dari jenis enumerasi XHR_AUTH yang ditentukan dalam file header Msxml6.h .
  • XHR_AUTH_ALL jika autentikasi diaktifkan (default).
  • XHR_AUTH_NONE jika autentikasi dinonaktifkan.
  • XHR_AUTH_PROXY jika autentikasi hanya boleh diaktifkan untuk autentikasi proksi.
XHR_PROP_TIMEOUT
Jumlah milidetik, hingga 0xFFFFFFFF, yang menunggu aplikasi sebelum waktu habis.
XHR_PROP_NO_DEFAULT_HEADERS
  • FALSE(0x0) untuk mengaktifkan penambahan header default (default).
  • TRUE(0x1) untuk menonaktifkan penambahan header default.
XHR_PROP_REPORT_REDIRECT_STATUS
  • FALSE(0x0) untuk tidak melaporkan status pengalihan (default).
  • TRUE(0x1) untuk melaporkan status pengalihan.
XHR_PROP_NO_CACHE
  • FALSE(0x0) untuk mengaktifkan penembolokan (default).
  • TRUE(0x1) untuk menonaktifkan penembolokan.
XHR_PROP_EXTENDED_ERROR
  • FALSE(0x0) untuk tidak memberikan kesalahan yang diperpanjang (default).
  • TRUE(0x1) untuk memberikan kesalahan yang diperluas .
XHR_PROP_QUERY_STRING_UTF8
  • FALSE(0x0) untuk tidak mengodekan string kueri di UTF-8 (default).
  • TRUE(0x1) untuk mengodekan string kueri di UTF-8.
XHR_PROP_IGNORE_CERT_ERRORS
  • FALSE(0x0) untuk tidak mengabaikan kesalahan sertifikat (default).
  • TRUE(0x1) untuk mengabaikan kesalahan sertifikat.

Mengembalikan nilai

Mengembalikan S_OK pada keberhasilan.

Keterangan

Metode SetProperty pada antarmuka IXMLHTTPRequest2 diperluas pada antarmuka IXMLHTTPRequest3 dengan properti baru untuk mendukung skenario baru:

  • XHR_PROP_NO_CACHE – Menekan pembacaan dan penulisan cache untuk permintaan HTTP.
  • XHR_PROP_EXTENDED_ERROR – Menyebabkan tumpukan HTTP menyediakan kode kesalahan Win32 yang mendasar kepada HRESULTS ke metode OnError jika terjadi kegagalan.
  • XHR_PROP_QUERY_STRING_UTF8 – Menyebabkan string kueri dikodekan dalam UTF-8 alih-alih ACP untuk permintaan HTTP.
  • XHR_PROP_IGNORE_CERT_ERRORS – Menekan kesalahan sertifikat server tertentu.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [aplikasi desktop | Aplikasi UWP],MSXML 6.0 dan yang lebih baru
Server minimum yang didukung Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header msxml6.h

Lihat juga

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

Buka

Enumerasi XHR_PROPERTY