Metode IXMLHTTPRequest2::SetProperty (msxml6.h)

Artikel
08/25/2023

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