Bendera API
Banyak fungsi WinINet menerima array bendera sebagai parameter. Berikut ini adalah deskripsi singkat tentang bendera yang ditentukan.
-
INTERNET_COOKIE_EVALUATE_P3P
-
-
0x80
-
Menunjukkan bahwa header Platform for Privacy Protection (P3P) akan dikaitkan dengan cookie.
-
-
INTERNET_COOKIE_THIRD_PARTY
-
-
0x10
-
Menunjukkan bahwa cookie pihak ketiga sedang diatur atau diambil.
-
-
INTERNET_FLAG_ASYNC
-
-
0x10000000
-
Hanya membuat permintaan asinkron pada handel yang turun dari handel yang dikembalikan dari fungsi ini. Hanya fungsi InternetOpen yang menggunakan bendera ini.
-
-
INTERNET_FLAG_CACHE_ASYNC
-
-
0x00000080
-
Memungkinkan penulisan cache malas.
-
-
INTERNET_FLAG_CACHE_IF_NET_FAIL
-
-
0x00010000
-
Mengembalikan sumber daya dari cache jika permintaan jaringan untuk sumber daya gagal karena kesalahan ERROR_INTERNET_CONNECTION_RESET atau ERROR_INTERNET_CANNOT_CONNECT . Bendera ini digunakan oleh HttpOpenRequest.
-
-
INTERNET_FLAG_DONT_CACHE
-
-
0x04000000
-
Tidak menambahkan entitas yang dikembalikan ke cache. Ini identik dengan nilai pilihan, INTERNET_FLAG_NO_CACHE_WRITE.
-
-
INTERNET_FLAG_EXISTING_CONNECT
-
-
0x20000000
-
Mencoba menggunakan objek InternetConnect yang ada jika ada dengan atribut yang sama yang diperlukan untuk membuat permintaan. Ini hanya berguna dengan operasi FTP, karena FTP adalah satu-satunya protokol yang biasanya melakukan beberapa operasi selama sesi yang sama. WinINet menyimpan satu handel koneksi untuk setiap handel HINTERNET yang dihasilkan oleh InternetOpen. Fungsi InternetOpenUrl dan InternetConnect menggunakan bendera ini untuk koneksi Http dan Ftp.
-
-
INTERNET_FLAG_FORMS_SUBMIT
-
-
0x00000040
-
Menunjukkan bahwa ini adalah pengiriman Formulir.
-
-
INTERNET_FLAG_FROM_CACHE
-
-
0x01000000
-
Tidak membuat permintaan jaringan. Semua entitas dikembalikan dari cache. Jika item yang diminta tidak ada di cache, kesalahan yang sesuai, seperti ERROR_FILE_NOT_FOUND, dikembalikan. Hanya fungsi InternetOpen yang menggunakan bendera ini.
-
-
INTERNET_FLAG_FWD_BACK
-
-
0x00000020
-
Menunjukkan bahwa fungsi harus menggunakan salinan sumber daya yang saat ini berada di cache Internet. Tanggal kedaluwarsa dan informasi lain tentang sumber daya tidak diperiksa. Jika item yang diminta tidak ditemukan di cache Internet, sistem mencoba menemukan sumber daya pada jaringan. Nilai ini diperkenalkan di Microsoft Internet Explorer 5 dan dikaitkan dengan operasi tombol Teruskan dan Kembali dari Internet Explorer.
-
-
INTERNET_FLAG_HYPERLINK
-
-
0x00000400
-
Memaksa pemuatan ulang jika tidak ada waktu Kedaluwarsa dan tidak ada waktu LastModified yang dikembalikan dari server saat menentukan apakah akan memuat ulang item dari jaringan. Bendera ini dapat digunakan oleh FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest, dan InternetOpenUrl.
Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Juga digunakan oleh GopherFindFirstFile dan GopherOpenFile.
-
-
INTERNET_FLAG_IGNORE_CERT_CN_INVALID
-
-
0x00001000
-
Menonaktifkan pemeriksaan sertifikat berbasis SSL/PCT yang dikembalikan dari server terhadap nama host yang diberikan dalam permintaan. WinINet menggunakan pemeriksaan sederhana terhadap sertifikat dengan membandingkan untuk mencocokkan nama host dan aturan wildcarding sederhana. Bendera ini dapat digunakan oleh HttpOpenRequest dan InternetOpenUrl (untuk permintaan HTTP).
-
-
INTERNET_FLAG_IGNORE_CERT_DATE_INVALID
-
-
0x00002000
-
Menonaktifkan pemeriksaan sertifikat berbasis SSL/PCT untuk tanggal validitas yang tepat. Bendera ini dapat digunakan oleh HttpOpenRequest dan InternetOpenUrl (untuk permintaan HTTP).
-
-
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP
-
-
0x00008000
-
Menonaktifkan deteksi jenis pengalihan khusus ini. Ketika bendera ini digunakan, WinINet secara transparan memungkinkan pengalihan dari HTTPS ke URL HTTP. Bendera ini dapat digunakan oleh HttpOpenRequest dan InternetOpenUrl (untuk permintaan HTTP).
-
-
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS
-
-
0x00004000
-
Menonaktifkan deteksi jenis pengalihan khusus ini. Ketika bendera ini digunakan, WinINet secara transparan mengizinkan pengalihan dari URL HTTP ke HTTPS. Bendera ini dapat digunakan oleh HttpOpenRequest dan InternetOpenUrl (untuk permintaan HTTP).
-
-
INTERNET_FLAG_KEEP_CONNECTION
-
-
0x00400000
-
Menggunakan semantik tetap hidup, jika tersedia, untuk koneksi. Bendera ini digunakan oleh HttpOpenRequest dan InternetOpenUrl (untuk permintaan HTTP). Bendera ini diperlukan untuk Microsoft Network (MSN), NTLM, dan jenis autentikasi lainnya.
-
-
INTERNET_FLAG_MAKE_PERSISTENT
-
-
0x02000000
-
Tidak lagi didukung.
-
-
INTERNET_FLAG_MUST_CACHE_REQUEST
-
-
0x00000010
-
Identik dengan nilai pilihan, INTERNET_FLAG_NEED_FILE. Menyebabkan file sementara dibuat jika file tidak dapat di-cache. Bendera ini dapat digunakan oleh FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest, dan InternetOpenUrl.
Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Juga digunakan oleh GopherFindFirstFile dan GopherOpenFile.
-
-
INTERNET_FLAG_NEED_FILE
-
-
0x00000010
-
Menyebabkan file sementara dibuat jika file tidak dapat di-cache. Bendera ini dapat digunakan oleh FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest, dan InternetOpenUrl.
Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Juga digunakan oleh GopherFindFirstFile dan GopherOpenFile.
-
-
INTERNET_FLAG_NO_AUTH
-
-
0x00040000
-
Tidak mencoba autentikasi secara otomatis. Bendera ini dapat digunakan oleh HttpOpenRequest dan InternetOpenUrl (untuk permintaan HTTP).
-
-
INTERNET_FLAG_NO_AUTO_REDIRECT
-
-
0x00200000
-
Tidak secara otomatis menangani pengalihan di HttpSendRequest. Bendera ini juga dapat digunakan oleh InternetOpenUrl untuk permintaan HTTP.
-
-
INTERNET_FLAG_NO_CACHE_WRITE
-
-
0x04000000
-
Tidak menambahkan entitas yang dikembalikan ke cache. Bendera ini digunakan oleh , HttpOpenRequest, dan InternetOpenUrl.
Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Juga digunakan oleh GopherFindFirstFile dan GopherOpenFile.
-
-
INTERNET_FLAG_NO_COOKIES
-
-
0x00080000
-
Tidak secara otomatis menambahkan header cookie ke permintaan, dan tidak secara otomatis menambahkan cookie yang dikembalikan ke database cookie. Bendera ini dapat digunakan oleh HttpOpenRequest dan InternetOpenUrl (untuk permintaan HTTP).
-
-
INTERNET_FLAG_NO_UI
-
-
0x00000200
-
Menonaktifkan kotak dialog cookie. Bendera ini dapat digunakan oleh HttpOpenRequest dan InternetOpenUrl (hanya permintaan HTTP).
-
-
INTERNET_FLAG_OFFLINE
-
-
0x01000000
-
Identik dengan INTERNET_FLAG_FROM_CACHE. Tidak membuat permintaan jaringan. Semua entitas dikembalikan dari cache. Jika item yang diminta tidak ada di cache, kesalahan yang sesuai, seperti ERROR_FILE_NOT_FOUND, dikembalikan. Hanya fungsi InternetOpen yang menggunakan bendera ini.
-
-
INTERNET_FLAG_PASSIVE
-
-
0x08000000
-
Menggunakan semantik FTP pasif. Hanya InternetConnect dan InternetOpenUrl yang menggunakan bendera ini. InternetConnect menggunakan bendera ini untuk permintaan FTP, dan InternetOpenUrl menggunakan bendera ini untuk file dan direktori FTP.
-
-
INTERNET_FLAG_PRAGMA_NOCACHE
-
-
0x00000100
-
Memaksa permintaan diselesaikan oleh server asal, bahkan jika salinan cache ada di proksi. Fungsi InternetOpenUrl (hanya pada permintaan HTTP dan HTTPS) dan fungsi HttpOpenRequest menggunakan bendera ini.
-
-
INTERNET_FLAG_RAW_DATA
-
-
0x40000000
-
Mengembalikan data sebagai struktur WIN32_FIND_DATA saat mengambil informasi direktori FTP. Jika bendera ini tidak ditentukan atau jika panggilan dilakukan melalui proksi CERN, InternetOpenUrl mengembalikan versi HTML direktori. Hanya fungsi InternetOpenUrl yang menggunakan bendera ini.
Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Juga mengembalikan struktur GOPHER_FIND_DATA saat mengambil informasi direktori Gopher.
-
-
INTERNET_FLAG_READ_PREFETCH
-
-
0x00100000
-
Bendera ini saat ini dinonaktifkan.
-
-
INTERNET_FLAG_RELOAD
-
-
0x80000000
-
Memaksa pengunduhan file, objek, atau daftar direktori yang diminta dari server asal, bukan dari cache. Fungsi FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest, dan InternetOpenUrl menggunakan bendera ini.
Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Juga digunakan oleh GopherFindFirstFile dan GopherOpenFile.
-
-
INTERNET_FLAG_RESTRICTED_ZONE
-
-
0x00020000
-
Menunjukkan bahwa cookie yang ditetapkan dikaitkan dengan situs yang tidak tepercaya.
-
-
INTERNET_FLAG_RESYNCHRONIZE
-
-
0x00000800
-
Memuat ulang sumber daya HTTP jika sumber daya telah dimodifikasi sejak terakhir kali diunduh. Semua sumber daya FTP dimuat ulang. Bendera ini dapat digunakan oleh FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest, dan InternetOpenUrl.
Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Juga digunakan oleh GopherFindFirstFile dan GopherOpenFile, dan sumber daya Gopher dimuat ulang.
-
-
INTERNET_FLAG_SECURE
-
-
0x00800000
-
Menggunakan semantik transaksi yang aman. Ini diterjemahkan menggunakan Secure Sockets Layer/Private Communications Technology (SSL/PCT) dan hanya bermakna dalam permintaan HTTP. Bendera ini digunakan oleh HttpOpenRequest dan InternetOpenUrl, tetapi ini berlebihan jika https:// muncul di URL. Fungsi InternetConnect menggunakan bendera ini untuk koneksi HTTP; semua handel permintaan yang dibuat di bawah koneksi ini akan mewarisi bendera ini.
-
-
INTERNET_FLAG_TRANSFER_ASCII
-
-
0x00000001
-
Mentransfer file sebagai ASCII (hanya FTP). Bendera ini dapat digunakan oleh FtpOpenFile, FtpGetFile, dan FtpPutFile.
-
-
INTERNET_FLAG_TRANSFER_BINARY
-
-
0x00000002
-
Mentransfer file sebagai biner (hanya FTP). Bendera ini dapat digunakan oleh FtpOpenFile, FtpGetFile, dan FtpPutFile.
-
-
INTERNET_NO_CALLBACK
-
-
0x00000000
-
Menunjukkan bahwa tidak ada panggilan balik yang harus dilakukan untuk API tersebut. Ini digunakan untuk parameter dxContext dari fungsi yang memungkinkan operasi asinkron.
-
-
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.
-
-
WININET_API_FLAG_ASYNC
-
-
0x00000001
-
Memaksa operasi asinkron.
-
-
WININET_API_FLAG_SYNC
-
-
0x00000004
-
Memaksa operasi sinkron.
-
-
WININET_API_FLAG_USE_CONTEXT
-
-
0x00000008
-
Memaksa API untuk menggunakan nilai konteks, bahkan jika diatur ke nol.
-
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 |
|