Baca dalam bahasa Inggris

Bagikan melalui


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
Wininet.h