Enumerasi WinHttpRequestOption

Artikel
06/03/2023

Enumerasi WinHttpRequestOption menyertakan opsi yang dapat diatur atau diambil untuk sesi Microsoft Windows HTTP Services (WinHTTP) saat ini.

Sintaks

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;

Konstanta

WinHttpRequestOption_UserAgentString

Mengatur atau mengambil VARIAN yang berisi string agen pengguna .

WinHttpRequestOption_URL

Mengambil VARIAN yang berisi URL sumber daya. Nilai ini bersifat baca-saja; Anda tidak dapat mengatur URL menggunakan properti ini. URL tidak dapat dibaca sampai metode Buka dipanggil. Opsi ini berguna untuk memeriksa URL setelah metode Kirim selesai untuk memverifikasi bahwa pengalihan apa pun terjadi.

WinHttpRequestOption_URLCodePage

Mengatur atau mengambil VARIAN yang mengidentifikasi halaman kode untuk string URL. Nilai defaultnya adalah halaman kode UTF-8. Halaman kode digunakan untuk mengonversi string URL Unicode, diteruskan dalam metode Buka , ke representasi string byte tunggal.

WinHttpRequestOption_EscapePercentInURL

Mengatur atau mengambil VARIAN yang menunjukkan apakah persentase karakter dalam string URL dikonversi ke urutan escape. Nilai default opsi ini adalah VARIANT_TRUE yang menentukan semua karakter American National Standards Institute (ANSI) yang tidak aman kecuali simbol persen dikonversi ke urutan escape.

WinHttpRequestOption_SslErrorIgnoreFlags

Mengatur atau mengambil VARIAN yang menunjukkan kesalahan sertifikat server mana yang harus diabaikan. Ini bisa menjadi kombinasi dari satu atau beberapa bendera berikut.

Kesalahan	Nilai
Otoritas sertifikasi (CA) tidak dikenal atau akar yang tidak tepercaya	0x0100
Penggunaan yang salah	0x0200
Nama umum (CN) tidak valid	0x1000
Tanggal atau sertifikat tidak valid kedaluwarsa	0x2000

Nilai default opsi ini di WinHTTP Versi 5.1 adalah nol, yang tidak mengabaikan kesalahan. Dalam versi WinHTTP yang lebih lama, pengaturan default 0x3300, yang mengakibatkan semua kesalahan sertifikat server diabaikan secara default.

WinHttpRequestOption_SelectCertificate

Mengatur VARIAN yang menentukan sertifikat klien yang dikirim ke server untuk autentikasi. Opsi ini menunjukkan lokasi, penyimpanan sertifikat, dan subjek sertifikat klien yang dibatasi dengan garis miring terbelakang. Untuk informasi selengkapnya tentang memilih sertifikat klien, lihat SSL di WinHTTP.

WinHttpRequestOption_EnableRedirects

Mengatur atau mengambil VARIAN yang menunjukkan apakah permintaan secara otomatis dialihkan saat server menentukan lokasi baru untuk sumber daya. Nilai default opsi ini adalah VARIANT_TRUE untuk menunjukkan bahwa permintaan dialihkan secara otomatis.

WinHttpRequestOption_UrlEscapeDisable

Mengatur atau mengambil VARIAN yang menunjukkan apakah karakter yang tidak aman di jalur dan komponen kueri URL dikonversi ke urutan escape. Nilai default opsi ini adalah VARIANT_TRUE, yang menentukan bahwa karakter di jalur dan kueri dikonversi.

WinHttpRequestOption_UrlEscapeDisableQuery

Mengatur atau mengambil VARIAN yang menunjukkan apakah karakter yang tidak aman dalam komponen kueri URL dikonversi ke urutan escape. Nilai default opsi ini adalah VARIANT_TRUE, yang menentukan bahwa karakter dalam kueri dikonversi.

WinHttpRequestOption_SecureProtocols

Mengatur atau mengambil VARIAN yang menunjukkan protokol aman mana yang dapat digunakan. Opsi ini memilih protokol yang dapat diterima oleh klien. Protokol ini dinegosiasikan selama jabat tangan Secure Sockets Layer (SSL). Ini bisa menjadi kombinasi dari satu atau beberapa bendera berikut.

Protokol	Nilai
SSL 2.0	0x0008
SSL 3.0	0x0020
Keamanan Lapisan Transportasi (TLS) 1.0	0x0080

Nilai default opsi ini adalah 0x0028, yang menunjukkan bahwa SSL 2.0 atau SSL 3.0 dapat digunakan. Jika opsi ini diatur ke nol, klien dan server tidak dapat menentukan protokol keamanan yang dapat diterima dan kirim berikutnya menghasilkan kesalahan.

WinHttpRequestOption_EnableTracing

Mengatur atau mengambil VARIAN yang menunjukkan apakah pelacakan saat ini diaktifkan. Lihat juga Mengumpulkan jejak WinHTTP.

WinHttpRequestOption_RevertImpersonationOverSsl

Mengontrol apakah objek WinHttpRequest untuk sementara mengembalikan peniruan klien selama durasi operasi autentikasi sertifikat SSL. Pengaturan default untuk objek WinHttpRequest adalah TRUE. Atur opsi ini ke FALSE untuk menyimpan peniruan saat melakukan operasi autentikasi sertifikat.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Mengontrol apakah WinHTTP mengizinkan pengalihan atau tidak. Secara default, semua pengalihan secara otomatis diikuti, kecuali yang mentransfer dari URL aman (https) ke URL (http) yang tidak aman. Atur opsi ini ke TRUE untuk mengaktifkan pengalihan HTTPS ke HTTP.

WinHttpRequestOption_EnablePassportAuthentication

Mengaktifkan atau menonaktifkan dukungan untuk autentikasi Paspor. Secara default, dukungan otomatis untuk autentikasi Paspor dinonaktifkan; atur opsi ini ke TRUE untuk mengaktifkan dukungan autentikasi Paspor.

WinHttpRequestOption_MaxAutomaticRedirects

Mengatur atau mengambil jumlah maksimum pengalihan yang diikuti WinHTTP; defaultnya adalah 10. Batas ini mencegah situs yang tidak sah membuat stall klien WinHTTP mengikuti sejumlah besar pengalihan.