Bendera Opsi (Wininet.h)

Artikel
06/13/2023

Bendera opsi berikut digunakan dengan fungsi InternetQueryOption dan InternetSetOption . Semua bendera opsi yang valid memiliki nilai yang lebih besar dari atau sama dengan INTERNET_FIRST_OPTION dan kurang dari atau sama dengan INTERNET_LAST_OPTION.

INTERNET_OPTION_ALTER_IDENTITY

80
Tidak diimplementasikan

INTERNET_OPTION_ASYNC

30
Tidak diterapkan.

INTERNET_OPTION_ASYNC_ID

15
Tidak diterapkan.

INTERNET_OPTION_ASYNC_PRIORITY

16
Tidak diterapkan.

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64
Mengatur atau mengambil nilai Boolean yang menentukan apakah sistem harus memeriksa jaringan untuk konten yang lebih baru dan menimpa entri cache yang diedit jika versi yang lebih baru ditemukan. Jika diatur ke True, sistem memeriksa jaringan untuk konten yang lebih baru dan menimpa entri cache yang diedit dengan versi yang lebih baru. Defaultnya adalah False, yang menunjukkan bahwa entri cache yang diedit harus digunakan tanpa memeriksa jaringan. Ini digunakan oleh InternetQueryOption dan InternetSetOption. Ini hanya valid di Microsoft Internet Explorer 5 dan yang lebih baru.

INTERNET_OPTION_CACHE_STREAM_HANDLE

27
Tidak lagi didukung.

INTERNET_OPTION_CACHE_TIMESTAMPS

69
Mengambil struktur INTERNET_CACHE_TIMESTAMPS yang berisi waktu LastModified dan Waktu kedaluwarsa dari sumber daya yang disimpan di cache Internet. Nilai ini digunakan oleh InternetQueryOption.

INTERNET_OPTION_CALLBACK

1
Mengatur atau mengambil alamat fungsi panggilan balik yang ditentukan untuk handel ini. Opsi ini dapat digunakan pada semua handel HINTERNET . Digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_CALLBACK_FILTER

54
Tidak diterapkan.

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84
Bendera ini tidak didukung oleh InternetQueryOption. Parameter lpBuffer harus berupa penunjuk ke struktur CERT_CONTEXT dan bukan penunjuk ke penunjuk CERT_CONTEXT . Jika aplikasi menerima ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED, aplikasi harus memanggil InternetErrorDlg atau menggunakan InternetSetOption untuk menyediakan sertifikat sebelum mencoba kembali permintaan. CertDuplicateCertificateContext kemudian dipanggil sehingga konteks sertifikat yang diteruskan dapat dirilis secara independen oleh aplikasi.

INTERNET_OPTION_CODEPAGE

68
Secara default, bagian host atau otoritas URL Unicode dikodekan sesuai dengan spesifikasi IDN. Mengatur opsi ini pada permintaan, atau handel koneksi, ketika IDN dinonaktifkan, menentukan skema pengodean halaman kode untuk bagian host URL. Parameter lpBuffer dalam panggilan ke InternetSetOption berisi halaman kode DBCS yang diinginkan. Jika tidak ada halaman kode yang ditentukan dalam lpBuffer, WinINet menggunakan halaman kode sistem default (CP_ACP). Catatan: Opsi ini diabaikan jika IDN tidak dinonaktifkan. Untuk informasi selengkapnya tentang cara menonaktifkan IDN, lihat opsi INTERNET_OPTION_IDN .

Windows XP dengan SP2 dan Windows Server 2003 dengan SP1: Bendera ini tidak didukung.

Versi: Membutuhkan Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_PATH

100
Secara default, bagian jalur URL dikodekan UTF8. API WinINet melakukan pengodean karakter escape (%) pada karakter high-bit. Mengatur opsi ini pada permintaan, atau handel koneksi, menonaktifkan pengodean UTF8 dan mengatur halaman kode tertentu. Parameter lpBuffer dalam panggilan ke InternetSetOption berisi halaman kode DBCS yang diinginkan untuk jalur tersebut. Jika tidak ada halaman kode yang ditentukan dalam lpBuffer, WinINet menggunakan CP_UTF8 default.

Windows XP dengan SP2 dan Windows Server 2003 dengan SP1: Bendera ini tidak didukung.

Versi: Membutuhkan Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_EXTRA

101
Secara default, bagian jalur URL adalah halaman kode sistem default (CP_ACP). Konversi karakter escape (%) tidak dilakukan pada bagian tambahan. Mengatur opsi ini pada permintaan, atau handel koneksi menonaktifkan pengodean CP_ACP. Parameter lpBuffer dalam panggilan ke InternetSetOption berisi halaman kode DBCS yang diinginkan untuk bagian tambahan URL. Jika tidak ada halaman kode yang ditentukan dalam lpBuffer, WinINet menggunakan halaman kode sistem default (CP_ACP).

Windows XP dengan SP2 dan Windows Server 2003 dengan SP1: Bendera ini tidak didukung.

Versi: Membutuhkan Internet Explorer 7.0.

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147
Untuk permintaan di mana WinInet mendekompresi server yang disediakan Content-Encoding, mengambil Content-Length yang dilaporkan server dari isi respons sebagai ULONGLONG. Didukung di Windows 10, versi 1507 dan yang lebih baru.

INTERNET_OPTION_CONNECT_BACKOFF

4
Tidak diterapkan.

INTERNET_OPTION_CONNECT_RETRIES

3
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi berapa kali WinINet mencoba mengatasi dan menyambungkan ke host. Ini hanya mencoba sekali per alamat IP. Misalnya, jika Anda mencoba menyambungkan ke host multihome yang memiliki sepuluh alamat IP dan INTERNET_OPTION_CONNECT_RETRIES diatur ke tujuh, WinINet hanya mencoba menyelesaikan dan menyambungkan ke tujuh alamat IP pertama. Sebaliknya, mengingat sekumpulan sepuluh alamat IP yang sama, jika INTERNET_OPTION_CONNECT_RETRIES diatur ke 20, WinINet mencoba masing-masing dari sepuluh hanya sekali. Jika host hanya memiliki satu alamat IP dan upaya koneksi pertama gagal, tidak ada upaya lebih lanjut. Jika upaya koneksi masih gagal setelah jumlah upaya yang ditentukan, permintaan dibatalkan. Nilai default untuk INTERNET_OPTION_CONNECT_RETRIES adalah lima upaya. Opsi ini dapat digunakan pada handel HINTERNET apa pun, termasuk handel NULL . Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_CONNECT_TIME

55
Tidak diterapkan.

INTERNET_OPTION_CONNECT_TIMEOUT

2
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi nilai waktu habis, dalam milidetik, untuk digunakan untuk permintaan koneksi Internet. Mengatur opsi ini ke tak terbatas (0xFFFFFFFF) akan menonaktifkan timer ini.

Jika permintaan koneksi membutuhkan waktu lebih lama dari nilai waktu habis ini, permintaan dibatalkan. Saat mencoba menyambungkan ke beberapa alamat IP untuk satu host (host multihome), batas waktu habis bersifat kumulatif untuk semua alamat IP. Opsi ini dapat digunakan pada handel HINTERNET apa pun, termasuk handel NULL . Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_CONNECTED_STATE

50
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi status tersambung. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_CONTEXT_VALUE

45
Mengatur atau mengambil DWORD_PTR yang berisi alamat nilai konteks yang terkait dengan handel HINTERNET ini. Opsi ini dapat digunakan pada handel HINTERNET apa pun. Ini digunakan oleh InternetQueryOption dan InternetSetOption. Sebelumnya, ini menetapkan nilai konteks ke alamat yang disimpan di penunjuk lpBuffer . Ini telah dikoreksi sehingga nilai yang disimpan dalam buffer digunakan dan bendera INTERNET_OPTION_CONTEXT_VALUE diberi nilai baru. Nilai lama, 10, telah dipertahankan sehingga aplikasi yang ditulis untuk perilaku lama masih didukung.

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6
Identik dengan INTERNET_OPTION_RECEIVE_TIMEOUT. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5
Identik dengan INTERNET_OPTION_SEND_TIMEOUT. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi nilai waktu habis, dalam milidetik, untuk menerima respons terhadap permintaan saluran data transaksi FTP. Jika respons membutuhkan waktu lebih lama dari nilai waktu habis ini, permintaan dibatalkan. Opsi ini dapat digunakan pada handel HINTERNET apa pun, termasuk handel NULL . Ini digunakan oleh InternetQueryOption dan InternetSetOption.

Bendera ini tidak berdampak pada fungsionalitas HTTP.

INTERNET_OPTION_DATA_SEND_TIMEOUT

7
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani, dalam milidetik, yang berisi nilai waktu habis untuk mengirim permintaan saluran data transaksi FTP. Jika pengiriman membutuhkan waktu lebih lama dari nilai waktu habis ini, pengiriman dibatalkan. Opsi ini dapat digunakan pada handel HINTERNET apa pun, termasuk handel NULL . Ini digunakan oleh InternetQueryOption dan InternetSetOption.

Bendera ini tidak berdampak pada fungsionalitas HTTP.

INTERNET_OPTION_DATAFILE_NAME

33
Mengambil nilai string yang berisi nama file yang mendukung entitas yang diunduh. Bendera ini valid setelah InternetOpenUrl, FtpOpenFile, GopherOpenFile, atau HttpOpenRequest telah selesai. Opsi ini hanya dapat dikueri oleh InternetQueryOption.

INTERNET_OPTION_DATAFILE_EXT

96
Mengatur nilai string yang berisi ekstensi file yang mendukung entitas yang diunduh. Bendera ini harus diatur sebelum memanggil InternetOpenUrl, FtpOpenFile, GopherOpenFile, atau HttpOpenRequest. Opsi ini hanya dapat diatur oleh InternetSetOption.

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67
Mengambil struktur INTERNET_DIAGNOSTIC_SOCKET_INFO yang berisi data tentang Permintaan HTTP tertentu. Bendera ini digunakan oleh InternetQueryOption.

Windows 7: Opsi ini tidak lagi didukung.

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76
Menyebabkan sistem keluar dari paket SSPI autentikasi Hash, membersihkan semua kredensial yang dibuat untuk proses tersebut. Tidak diperlukan buffer untuk opsi ini. Ini digunakan oleh InternetSetOption.

INTERNET_OPTION_DISABLE_AUTODIAL

70
Tidak diterapkan.

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49
Tidak diterapkan.

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148
Mengatur bitmask DWORD dari versi HTTP tingkat lanjut yang dapat diterima. Dapat diatur pada jenis handel apa pun. Potensi nilai: HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Didukung pada Windows 10, versi 1507 dan yang lebih baru. Versi lama HTTP (1.1 dan sebelumnya) tidak dapat dinonaktifkan menggunakan opsi ini. Defaultnya adalah 0x0. Didukung di Windows 10, versi 1507 dan yang lebih baru.

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122
Pada handel permintaan, mengatur Boolean yang mengontrol apakah pengalihan akan dikembalikan dari cache WinInet untuk permintaan tertentu. Defaultnya adalah FALSE. Didukung di Windows 8 dan yang lebih baru.

INTERNET_OPTION_ENCODE_EXTRA

155
Mendapatkan/mengatur BOOL yang menunjukkan apakah karakter non-ASCII dalam string kueri harus dikodekan persen. Defaultnya adalah FALSE. Didukung di Windows 8.1 dan yang lebih baru.

INTERNET_OPTION_END_BROWSER_SESSION

42
Menghapus entri yang tidak digunakan dari cache kata sandi pada hard disk drive. Juga mengatur ulang waktu cache yang digunakan saat mode sinkronisasi sekali per sesi. Tidak diperlukan buffer untuk opsi ini. Ini digunakan oleh InternetSetOption.

INTERNET_OPTION_ERROR_MASK

62
Mengatur nilai bilangan bulat panjang yang tidak ditandatangani yang berisi masker kesalahan yang dapat ditangani oleh aplikasi klien. Ini bisa menjadi kombinasi dari nilai berikut:

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

Menunjukkan bahwa semua kesalahan sertifikat harus dilaporkan menggunakan pengembalian kesalahan yang sama, yaitu ERROR_INTERNET_SEC_CERT_ERRORS. Jika bendera ini diatur, hubungi InternetErrorDlg saat menerima kesalahan ERROR_INTERNET_SEC_CERT_ERRORS , sehingga pengguna dapat merespons dialog yang sudah dikenal yang menjelaskan masalahnya.

Perhatian

Gagal memberi tahu pengguna tentang kesalahan ini mengekspos pengguna terhadap potensi serangan spoofing.

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

Menunjukkan bahwa aplikasi klien dapat menangani kode kesalahan ERROR_INTERNET_INSERT_CDROM .

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

Menunjukkan bahwa aplikasi klien dapat menangani kode kesalahan ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY .

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

Tidak diterapkan.

INTERNET_OPTION_ENTERPRISE_CONTEXT

159
Mengatur PWSTR yang berisi ID Perusahaan (lihat https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx) yang berlaku untuk permintaan. Didukung di Windows 10, versi 1507 dan yang lebih baru.

INTERNET_OPTION_EXTENDED_ERROR

24
Mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi kode kesalahan Winsock yang dipetakan ke pesan kesalahan ERROR_INTERNET_ terakhir dikembalikan dalam konteks utas ini. Opsi ini digunakan pada handel NULL HINTERNET oleh InternetQueryOption.

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63
Mengatur atau mengambil nilai bilangan bulat panjang a1n yang tidak ditandatangani yang berisi jumlah waktu sistem harus menunggu respons terhadap permintaan jaringan sebelum memeriksa cache untuk salinan sumber daya. Jika permintaan jaringan membutuhkan waktu lebih lama dari waktu yang ditentukan dan sumber daya yang diminta tersedia di cache, sumber daya diambil dari cache. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_HANDLE_TYPE

9
Mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi jenis handel HINTERNET yang diteruskan. Ini digunakan oleh InternetQueryOption pada handel HINTERNET apa pun. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157
Mendapatkan/mengatur BOOL yang menunjukkan apakah WinInet harus mengikuti arahan HTTP Strict Transport Security (HSTS) dari server. Jika diaktifkan, https:// permintaan schemed ke domain yang memiliki kebijakan HSTS yang di-cache oleh WinInet akan dialihkan ke URL https:// yang cocok. Defaultnya adalah FALSE. Didukung di Windows 8.1 dan yang lebih baru.

INTERNET_OPTION_HTTP_DECODING

65
Memungkinkan WinINet melakukan pendekodean untuk skema pengodean gzip dan deflate. Untuk informasi selengkapnya, lihat Pengodean Konten.

INTERNET_OPTION_HTTP_PROTOCOL_USED

149
Mendapatkan DWORD yang menunjukkan versi HTTP tingkat lanjut mana yang digunakan pada permintaan tertentu. Potensi nilai: HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Didukung pada Windows 10, versi 1507 dan yang lebih baru. 0x0 menunjukkan HTTP/1.1 atau yang lebih lama; lihat INTERNET_OPTION_HTTP_VERSION jika diperlukan lebih banyak presisi tentang versi warisan mana yang digunakan. Didukung pada Windows 10, versi 1507 dan yang lebih baru.

INTERNET_OPTION_HTTP_VERSION

59
Mengatur atau mengambil struktur HTTP_VERSION_INFO yang berisi versi HTTP yang didukung. Ini harus digunakan pada handel NULL . Ini digunakan oleh InternetQueryOption dan InternetSetOption.

Pada Windows 7, Windows Server 2008 R2, dan yang lebih baru, nilai anggota dwMinorVersion dalam struktur HTTP_VERSION_INFO ditimpa oleh pengaturan Internet Explorer. EnableHttp1_1 adalah nilai registri di bawah HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE yang dikontrol oleh Internet Options yang diatur di Internet Explorer untuk sistem. Nilai EnableHttp1_1 default ke 1. Struktur HTTP_VERSION_INFO diabaikan untuk versi HTTP apa pun kurang dari 1.1 jika EnableHttp1_1 diatur ke 1.

INTERNET_OPTION_IDENTITY

78
Tidak diterapkan.

INTERNET_OPTION_IDLE_STATE

51
Tidak diterapkan.

INTERNET_OPTION_IDN

102
Secara default, bagian host atau otoritas URL dikodekan sesuai dengan spesifikasi IDN untuk koneksi langsung dan proksi. Opsi ini dapat digunakan pada permintaan, atau handel koneksi untuk mengaktifkan atau menonaktifkan IDN. Ketika IDN dinonaktifkan, WinINet menggunakan halaman kode sistem untuk mengodekan host atau bagian otoritas URL. Untuk menonaktifkan konversi host IDN, atur parameter lpBuffer dalam panggilan ke InternetSetOption ke nol. Untuk mengaktifkan konversi IDN hanya pada koneksi langsung, tentukan INTERNET_FLAG_IDN_DIRECT dalam parameter lpBuffer dalam panggilan ke InternetSetOption. Untuk mengaktifkan konversi IDN hanya pada koneksi proksi, tentukan INTERNET_FLAG_IDN_PROXY dalam parameter lpBuffer dalam panggilan ke InternetSetOption.

Windows XP dengan SP2 dan Windows Server 2003 dengan SP1: Bendera ini tidak didukung.

Versi: Membutuhkan Internet Explorer 7.0.

INTERNET_OPTION_IGNORE_OFFLINE

77
Mengatur atau mengambil apakah bendera offline global harus diabaikan untuk handel permintaan yang ditentukan. Tidak ada buffer yang diperlukan untuk opsi ini. Ini digunakan oleh InternetQueryOption dan InternetSetOption dengan handel permintaan. Opsi ini hanya valid di Internet Explorer 5 dan yang lebih baru.

INTERNET_OPTION_KEEP_CONNECTION

22
Tidak diterapkan.

INTERNET_OPTION_LISTEN_TIMEOUT

11
Tidak diterapkan.

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi jumlah maksimum koneksi yang diizinkan per server HTTP/1.0. Ini digunakan oleh InternetQueryOption dan InternetSetOption. Opsi ini hanya valid di Internet Explorer 5 dan yang lebih baru.

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi jumlah maksimum koneksi yang diizinkan per proksi CERN. Ketika opsi ini diatur atau diambil, parameter hInternet harus diatur ke nilai handel null . Nilai handel null menunjukkan bahwa opsi harus diatur atau dikueri untuk proses saat ini. Saat memanggil InternetSetOption dengan opsi ini, semua objek proksi yang ada akan menerima nilai baru. Nilai ini terbatas pada rentang 2 hingga 128, inklusif.

Versi: Membutuhkan Internet Explorer 8.0.

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi jumlah maksimum koneksi yang diizinkan per server. Ini digunakan oleh InternetQueryOption dan InternetSetOption. Opsi ini hanya valid di Internet Explorer 5 dan yang lebih baru.

INTERNET_OPTION_OFFLINE_MODE

26
Tidak diterapkan.

INTERNET_OPTION_OFFLINE_SEMANTICS

52
Tidak diterapkan.

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176
Keikutsertaan untuk tanda tangan yang lemah (misalnya SHA-1) diperlakukan sebagai tidak aman. Ini akan menginstruksikan WinInet untuk memanggil CertGetCertificateChain menggunakan parameter CERT_CHAIN_OPT_IN_WEAK_SIGNATURE .

INTERNET_OPTION_PARENT_HANDLE

21
Mengambil handel induk ke handel ini. Opsi ini dapat digunakan pada handel HINTERNET apa pun oleh InternetQueryOption.

INTERNET_OPTION_PASSWORD

29
Mengatur atau mengambil nilai string yang berisi kata sandi yang terkait dengan handel yang dikembalikan oleh InternetConnect. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_PER_CONNECTION_OPTION

75
Mengatur atau mengambil struktur INTERNET_PER_CONN_OPTION_LIST yang menentukan daftar opsi untuk koneksi tertentu. Ini digunakan oleh InternetQueryOption dan InternetSetOption. Opsi ini hanya valid di Internet Explorer 5 dan yang lebih baru.

Catatan

INTERNET_OPTION_PER_CONNECTION_OPTION menyebabkan pengaturan diubah berdasarkan sistem saat handel NULL digunakan dalam panggilan ke InternetSetOption. Untuk menyegarkan pengaturan proksi global, Anda harus memanggil InternetSetOption dengan bendera opsi INTERNET_OPTION_REFRESH .

Catatan

Untuk mengubah informasi proksi untuk seluruh proses tanpa mempengaruhi pengaturan global di Internet Explorer 5 dan yang lebih baru, gunakan opsi ini pada handel yang dikembalikan dari InternetBuka. Contoh kode berikut mengubah proksi untuk seluruh proses meskipun handel HINTERNET ditutup dan tidak digunakan oleh permintaan apa pun.

INTERNET_OPTION_POLICY

48
Tidak diterapkan.

INTERNET_OPTION_PROXY

38
Mengatur atau mengambil struktur INTERNET_PROXY_INFO yang berisi data proksi untuk handel InternetOpen yang ada saat handel HINTERNET bukan NULL. Jika handel HINTERNETADALAH NULL, fungsi menetapkan atau mengkueri data proksi global. Opsi ini dapat digunakan pada handel yang dikembalikan oleh InternetBuka. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

Catatan

Disarankan agar INTERNET_OPTION_PER_CONNECTION_OPTION digunakan alih-alih INTERNET_OPTION_PROXY.

INTERNET_OPTION_PROXY_PASSWORD

44
Mengatur atau mengambil nilai string yang berisi kata sandi yang digunakan untuk mengakses proksi. Ini digunakan oleh InternetQueryOption dan InternetSetOption. Opsi ini dapat diatur pada handel yang dikembalikan oleh InternetConnect atau HttpOpenRequest.

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95
Memperingatkan instans WinInet saat ini bahwa pengaturan proksi telah berubah dan harus diperbarui dengan pengaturan baru. Untuk memperingatkan semua instans WinInet yang tersedia, atur parameter BufferInternetSetOption ke NULL dan BufferLength ke 0 saat meneruskan opsi ini. Opsi ini dapat diatur pada handel yang dikembalikan oleh InternetConnect atau HttpOpenRequest.

INTERNET_OPTION_PROXY_USERNAME

43
Mengatur atau mengambil nilai string yang berisi nama pengguna yang digunakan untuk mengakses proksi. Ini digunakan oleh InternetQueryOption dan InternetSetOption. Opsi ini dapat diatur pada handel yang dikembalikan oleh InternetConnect atau HttpOpenRequest.

INTERNET_OPTION_READ_BUFFER_SIZE

12
Mengatur atau mengambil nilai bilangan buffer panjang yang tidak ditandatangani yang berisi ukuran buffer baca. Opsi ini dapat digunakan pada handel HINTERNET yang dikembalikan oleh FtpOpenFile, FtpFindFirstFile, dan InternetConnect (hanya sesi FTP). Opsi ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_RECEIVE_THROUGHPUT

57
Tidak diterapkan.

INTERNET_OPTION_RECEIVE_TIMEOUT

6
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi nilai waktu habis, dalam milidetik, untuk menerima respons terhadap permintaan. Jika respons membutuhkan waktu lebih lama dari nilai waktu habis ini, permintaan dibatalkan. Opsi ini dapat digunakan pada handel HINTERNET apa pun, termasuk handel NULL . Ini digunakan oleh InternetQueryOption dan InternetSetOption.

Opsi ini tidak dimaksudkan untuk mewakili batas waktu langsung yang halus. Anda dapat mengharapkan batas waktu terjadi hingga enam detik setelah nilai batas waktu yang ditetapkan.

Ketika digunakan sebagai referensi ke transaksi FTP, opsi ini mengacu pada saluran kontrol.

INTERNET_OPTION_REFRESH

37
Menyebabkan data proksi dibaca ulang dari registri untuk handel. Tidak diperlukan buffer. Opsi ini dapat digunakan pada handel HINTERNET yang dikembalikan oleh InternetOpen. Ini digunakan oleh InternetSetOption.

INTERNET_OPTION_REMOVE_IDENTITY

79
Tidak diterapkan.

INTERNET_OPTION_REQUEST_FLAGS

23
Mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi bendera status khusus yang menunjukkan status unduhan yang sedang berlangsung. Ini digunakan oleh InternetQueryOption. Opsi INTERNET_OPTION_REQUEST_FLAGS bisa menjadi salah satu nilai berikut:

INTERNET_REQFLAG_ASYNC

0x00000002

Tidak diterapkan.

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

Permintaan internet tidak dapat di-cache (permintaan HTTPS, misalnya).

INTERNET_REQFLAG_FROM_CACHE

0x00000001

Respons datang dari cache.

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

Waktu permintaan internet habis.

INTERNET_REQFLAG_NO_HEADERS

0x00000008

Respons asli tidak berisi header.

INTERNET_REQFLAG_PASSIVE

0x00000010

Tidak diterapkan.

INTERNET_REQFLAG_VIA_PROXY

0x00000004

Permintaan dibuat melalui proksi.

INTERNET_OPTION_REQUEST_PRIORITY

58
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi prioritas permintaan yang bersaing untuk koneksi pada handel HTTP. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_RESET_URLCACHE_SESSION

60
Memulai sesi cache baru untuk proses tersebut. Tidak diperlukan buffer. Ini digunakan oleh InternetSetOption. Opsi ini hanya dicadangkan untuk penggunaan internal.

INTERNET_OPTION_SECONDARY_CACHE_KEY

53
Mengatur atau mengambil nilai string yang berisi kunci cache sekunder. Ini digunakan oleh InternetQueryOption dan InternetSetOption. Opsi ini hanya dicadangkan untuk penggunaan internal.

INTERNET_OPTION_SECURITY_CERTIFICATE

35
Mengambil sertifikat untuk server SSL/PCT (Secure Sockets Layer/Private Communications Technology) ke dalam string yang diformat. Ini digunakan oleh InternetQueryOption.

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32
Mengambil sertifikat untuk server SSL/PCT ke dalam struktur INTERNET_CERTIFICATE_INFO. Ini digunakan oleh InternetQueryOption.

INTERNET_OPTION_SECURITY_FLAGS

31
Mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi bendera keamanan untuk handel. Opsi ini digunakan oleh InternetQueryOption. Ini bisa menjadi kombinasi dari nilai berikut.

SECURITY_FLAG_128BIT

0x20000000

Identik dengan nilai pilihan SECURITY_FLAG_STRENGTH_STRONG. Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

SECURITY_FLAG_40BIT

0x10000000

Identik dengan nilai pilihan SECURITY_FLAG_STRENGTH_WEAK. Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

SECURITY_FLAG_56BIT

0x40000000

Identik dengan nilai pilihan SECURITY_FLAG_STRENGTH_MEDIUM. Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

SECURITY_FLAG_FORTEZZA

0x08000000

Menunjukkan Fortezza telah digunakan untuk memberikan kerahasiaan, autentikasi, dan/atau integritas untuk koneksi yang ditentukan.

SECURITY_FLAG_IETFSSL4

0x00000020

Tidak diterapkan.

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Mengabaikan pesan kesalahan ERROR_INTERNET_SEC_CERT_CN_INVALID .

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Mengabaikan pesan kesalahan ERROR_INTERNET_SEC_CERT_DATE_INVALID .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Mengabaikan pesan kesalahan ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Mengabaikan pesan kesalahan ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR .

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

Mengabaikan masalah pencabutan sertifikat.

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

Mengabaikan masalah otoritas sertifikat yang tidak diketahui.

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

Mengabaikan masalah tanda tangan sertifikat yang lemah.

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

Mengabaikan masalah penggunaan yang salah.

SECURITY_FLAG_NORMALBITNESS

0x10000000

Identik dengan nilai SECURITY_FLAG_STRENGTH_WEAK. Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

SECURITY_FLAG_PCT

0x00000008

Tidak diterapkan.

SECURITY_FLAG_PCT4

0x00000010

Tidak diterapkan.

SECURITY_FLAG_SECURE

0x00000001

Menggunakan transfer aman. Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

SECURITY_FLAG_SSL

0x00000002

Tidak diterapkan.

SECURITY_FLAG_SSL3

0x00000004

Tidak diterapkan.

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

Menggunakan enkripsi sedang (56-bit). Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

Menggunakan enkripsi yang kuat (128-bit). Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

Menggunakan enkripsi lemah (40-bit). Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

SECURITY_FLAG_UNKNOWNBIT

0x80000000

Ukuran bit yang digunakan dalam enkripsi tidak diketahui. Ini hanya dikembalikan dalam panggilan ke InternetQueryOption.

Ketahuilah bahwa data yang diambil dengan cara ini berkaitan dengan transaksi yang telah terjadi, yang tingkat keamanannya tidak dapat diubah lagi.

INTERNET_OPTION_SECURITY_KEY_BITNESS

36
Mengambil nilai bilangan bulat panjang yang tidak ditandatangani yang berisi ukuran bit kunci enkripsi. Semakin besar jumlahnya, semakin besar kekuatan enkripsi yang digunakan. Ini digunakan oleh InternetQueryOption. Ketahuilah bahwa data yang diambil dengan cara ini berkaitan dengan transaksi yang telah terjadi, yang tingkat keamanannya tidak dapat lagi diubah.

INTERNET_OPTION_SEND_THROUGHPUT

56
Tidak diterapkan.

INTERNET_OPTION_SEND_TIMEOUT

5
Mengatur atau mengambil nilai bilangan bulat panjang yang tidak ditandatangani, dalam milidetik, yang berisi nilai batas waktu untuk mengirim permintaan. Jika pengiriman membutuhkan waktu lebih lama dari nilai waktu habis ini, pengiriman dibatalkan. Opsi ini dapat digunakan pada handel HINTERNET apa pun, termasuk handel NULL . Ini digunakan oleh InternetQueryOption dan InternetSetOption.

Ketika digunakan sebagai referensi ke transaksi FTP, opsi ini mengacu pada saluran kontrol.

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105
Mengambil konteks rantai sertifikat server sebagai PCCERT_CHAIN_CONTEXT duplikat. Anda dapat meneruskan konteks duplikat ini ke fungsi Crypto API apa pun yang mengambil PCCERT_CHAIN_CONTEXT. Anda harus memanggil CertFreeCertificateChain pada PCCERT_CHAIN_CONTEXT yang dikembalikan ketika Anda selesai dengan konteks rantai sertifikat.

Versi: Membutuhkan Internet Explorer 8.0.

INTERNET_OPTION_SETTINGS_CHANGED

39
Memberi tahu sistem bahwa pengaturan registri telah diubah sehingga memverifikasi pengaturan pada panggilan berikutnya ke InternetConnect. Ini digunakan oleh InternetSetOption.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104
Mengatur objek permintaan HTTP sehingga tidak akan masuk ke server asal, tetapi akan melakukan masuk otomatis ke server proksi HTTP. Opsi ini berbeda dari bendera Permintaan INTERNET_FLAG_NO_AUTH, yang mencegah autentikasi ke server proksi dan server asal.

Mengatur mode ini akan menekan penggunaan materi kredensial apa pun (baik nama pengguna/kata sandi yang disediakan sebelumnya atau sertifikat SSL klien) saat berkomunikasi dengan server asal. Namun, jika permintaan harus transit melalui proksi autentikasi, WinINet masih akan melakukan autentikasi otomatis ke proksi HTTP per pengaturan Zona Intranet untuk pengguna. Pengaturan Zona Intranet default adalah mengizinkan masuk otomatis menggunakan kredensial default pengguna.

Untuk memastikan penekanan semua informasi identifikasi, pemanggil harus menggabungkan INTERNET_OPTION_SUPPRESS_SERVER_AUTH dengan bendera permintaan INTERNET_FLAG_NO_COOKIES .

Opsi ini hanya dapat diatur pada objek permintaan sebelum dikirim. Upaya untuk mengatur opsi ini setelah permintaan dikirim akan mengembalikan ERROR_INTERNET_INCORRECT_HANDLE_STATE.

Tidak diperlukan buffer untuk opsi ini. Ini digunakan oleh InternetSetOption pada handel yang dikembalikan oleh HttpOpenRequest saja.

Versi: Memerlukan Internet Explorer 8.0 atau yang lebih baru.

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81
Opsi tujuan umum yang digunakan untuk menekan perilaku secara proses. Parameter lpBuffer dari fungsi harus menjadi penunjuk ke DWORD yang berisi perilaku khusus untuk ditekan. Opsi ini tidak dapat dikueri dengan InternetQueryOption. Nilai yang diizinkan adalah:

INTERNET_SUPPRESS_RESET_ALL

0

Menonaktifkan semua supresi, mengaktifkan kembali perilaku default dan yang dikonfigurasi. Opsi ini setara dengan pengaturan INTERNET_SUPPRESS_COOKIE_POLICY_RESET dan INTERNET_SUPPRESS_COOKIE_PERSIST_RESET satu per satu.

Versi: Memerlukan Internet Explorer 6.0 atau yang lebih baru.

INTERNET_SUPPRESS_COOKIE_POLICY

1

Mengabaikan kebijakan cookie yang dikonfigurasi dan memungkinkan cookie diatur.

Versi: Memerlukan Internet Explorer 6.0 atau yang lebih baru.

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

Menonaktifkan penindasan INTERNET_SUPPRESS_COOKIE_POLICY , mengizinkan evaluasi cookie sesuai dengan kebijakan cookie yang dikonfigurasi.

Versi: Memerlukan Internet Explorer 6.0 atau yang lebih baru.

INTERNET_SUPPRESS_COOKIE_PERSIST

3

Menekan persistensi cookie, bahkan jika server telah menentukannya sebagai persisten.

Versi: Memerlukan Internet Explorer 8.0 atau yang lebih baru.

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

Menonaktifkan supresi INTERNET_SUPPRESS_COOKIE_PERSIST , mengaktifkan kembali kegigihan cookie. Cookie yang ditekan sebelumnya tidak akan menjadi persisten.

Versi: Memerlukan Internet Explorer 8.0 atau yang lebih baru.

INTERNET_OPTION_URL

34
Mengambil nilai string yang berisi URL lengkap sumber daya yang diunduh. Jika URL asli berisi data tambahan, seperti string pencarian atau jangkar, atau jika panggilan dialihkan, URL yang dikembalikan berbeda dari aslinya. Opsi ini berlaku pada handel HINTERNET yang dikembalikan oleh InternetOpenUrl, FtpOpenFile, GopherOpenFile, atau HttpOpenRequest. Ini digunakan oleh InternetQueryOption.

INTERNET_OPTION_USER_AGENT

41
Mengatur atau mengambil string agen pengguna pada handel yang disediakan oleh InternetOpen dan digunakan dalam fungsi HttpSendRequest berikutnya, selama tidak ditimpa oleh header yang ditambahkan oleh HttpAddRequestHeaders atau HttpSendRequest. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_USERNAME

28
Mengatur atau mengambil string yang berisi nama pengguna yang terkait dengan handel yang dikembalikan oleh InternetConnect. Ini digunakan oleh InternetQueryOption dan InternetSetOption.

INTERNET_OPTION_VERSION

40
Mengambil struktur INTERNET_VERSION_INFO yang berisi nomor versi Wininet.dll. Opsi ini dapat digunakan pada handel NULL HINTERNET oleh InternetQueryOption.

INTERNET_OPTION_WRITE_BUFFER_SIZE

13
Mengatur atau mengambil nilai bilangan buffer panjang yang tidak ditandatangani yang berisi ukuran, dalam byte, dari buffer tulis. Opsi ini dapat digunakan pada handel HINTERNET yang dikembalikan oleh FtpOpenFile dan InternetConnect (hanya sesi FTP). Ini digunakan oleh InternetQueryOption dan InternetSetOption.

Keterangan

Catatan

WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Wininet.h; Winineti.h

Bagikan melalui

Bendera Opsi (Wininet.h)

Keterangan

Persyaratan

Saran dan Komentar

Sumber Daya Tambahan: