Fungsi InternetOpenW (wininet.h)

Artikel
03/04/2024

Menginisialisasi penggunaan fungsi WinINet oleh aplikasi.

Sintaks

HINTERNET InternetOpenW(
  [in] LPCWSTR lpszAgent,
  [in] DWORD   dwAccessType,
  [in] LPCWSTR lpszProxy,
  [in] LPCWSTR lpszProxyBypass,
  [in] DWORD   dwFlags
);

Parameter

[in] lpszAgent

Penunjuk ke string yang dihentikan null yang menentukan nama aplikasi atau entitas yang memanggil fungsi WinINet. Nama ini digunakan sebagai agen pengguna dalam protokol HTTP.

[in] dwAccessType

Jenis akses yang diperlukan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
INTERNET_OPEN_TYPE_DIRECT	Menyelesaikan semua nama host secara lokal.
INTERNET_OPEN_TYPE_PRECONFIG	Mengambil proksi atau konfigurasi langsung dari registri.
INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY	Mengambil proksi atau konfigurasi langsung dari registri dan mencegah penggunaan file Microsoft JScript atau Internet Setup (INS) startup.
INTERNET_OPEN_TYPE_PROXY	Meneruskan permintaan ke proksi kecuali daftar bypass proksi disediakan dan nama yang akan diselesaikan melewati proksi. Dalam hal ini, fungsi menggunakan INTERNET_OPEN_TYPE_DIRECT.

[in] lpszProxy

Penunjuk ke string yang dihentikan null yang menentukan nama server proksi yang akan digunakan saat akses proksi ditentukan dengan mengatur dwAccessType ke INTERNET_OPEN_TYPE_PROXY. Jangan gunakan string kosong, karena InternetOpen akan menggunakannya sebagai nama proksi. Fungsi WinINet hanya mengenali proksi jenis CERN (hanya HTTP) dan gateway TIS FTP (hanya FTP). Jika Microsoft Internet Explorer diinstal, fungsi-fungsi ini juga mendukung proksi SOCKS. Permintaan FTP dapat dibuat melalui proksi jenis CERN baik dengan mengubahnya menjadi permintaan HTTP atau dengan menggunakan InternetOpenUrl. Jika dwAccessType tidak diatur ke INTERNET_OPEN_TYPE_PROXY, parameter ini diabaikan dan harus NULL. Untuk informasi selengkapnya tentang mencantumkan server proksi, lihat bagian Mencantumkan Server Proksi di Mengaktifkan Fungsionalitas Internet.

[in] lpszProxyBypass

Penunjuk ke string yang dihentikan null yang menentukan daftar opsional nama host atau alamat IP, atau keduanya, yang tidak boleh dirutekan melalui proksi ketika dwAccessType diatur ke INTERNET_OPEN_TYPE_PROXY. Daftar ini dapat berisi kartubebas. Jangan gunakan string kosong, karena InternetOpen akan menggunakannya sebagai daftar bypass proksi. Jika parameter ini menentukan makro "lokal>"<, fungsi melewati proksi untuk nama host apa pun yang tidak berisi titik.

Secara default, WinINet akan melewati proksi untuk permintaan yang menggunakan nama host "localhost", "loopback", "127.0.0.1", atau "[::1]". Perilaku ini ada karena server proksi jarak jauh biasanya tidak akan menyelesaikan alamat ini dengan benar. Internet Explorer 9: Anda dapat menghapus komputer lokal dari daftar bypass proksi menggunakan makro "<-loopback>".

Jika dwAccessType tidak diatur ke INTERNET_OPEN_TYPE_PROXY, parameter ini diabaikan dan harus NULL.

[in] dwFlags

Opsi. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
INTERNET_FLAG_ASYNC	Hanya membuat permintaan asinkron pada handel yang turun dari handel yang dikembalikan dari fungsi ini.
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.
INTERNET_FLAG_OFFLINE	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.

Nilai kembali

Mengembalikan handel yang valid yang diteruskan aplikasi ke fungsi WinINet berikutnya. Jika InternetBuka gagal, maka akan mengembalikan NULL. Untuk mengambil pesan kesalahan tertentu, panggil GetLastError.

Keterangan

InternetOpen adalah fungsi WinINet pertama yang dipanggil oleh aplikasi. Ini memberi tahu DLL Internet untuk menginisialisasi struktur data internal dan mempersiapkan panggilan di masa mendatang dari aplikasi. Ketika aplikasi selesai menggunakan fungsi Internet, aplikasi harus memanggil InternetCloseHandle untuk membebaskan handel dan sumber daya terkait.

Aplikasi ini dapat melakukan sejumlah panggilan ke InternetBuka, meskipun satu panggilan biasanya cukup. Aplikasi mungkin perlu menentukan perilaku terpisah untuk setiap instans InternetOpen , seperti server proksi yang berbeda yang dikonfigurasi untuk masing-masing instans.

Setelah aplikasi panggilan selesai menggunakan handel HINTERNET yang dikembalikan oleh InternetOpen, aplikasi harus ditutup menggunakan fungsi InternetCloseHandle .

Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

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).

Catatan

Header wininet.h mendefinisikan InternetOpen sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

Mengaktifkan Fungsionalitas Internet

Fungsi WinINet

Bagikan melalui