Fungsi InternetOpenA (wininet.h)

Artikel
11/20/2024

Menginisialisasi penggunaan fungsi WinINet aplikasi.

Sintaksis

HINTERNET InternetOpenA(
  [in] LPCSTR lpszAgent,
  [in] DWORD  dwAccessType,
  [in] LPCSTR lpszProxy,
  [in] LPCSTR lpszProxyBypass,
  [in] DWORD  dwFlags
);

Parameter

[in] lpszAgent

Penunjuk ke untainullyang 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	Arti
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 Startup Microsoft JScript atau Penyiapan Internet (INS).
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 stringnull yang dihentikan 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 InternetBuka 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 Mengaktifkan Fungsionalitas Internet.

[in] lpszProxyBypass

Penunjuk ke stringnull yang menentukan daftar opsional nama host atau alamat IP, atau keduanya, yang seharusnya tidak dirutekan melalui proksi ketika dwAccessType diatur ke INTERNET_OPEN_TYPE_PROXY. Daftar dapat berisi kartubebas. Jangan gunakan string kosong, karena InternetBuka 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

Pilihan. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Arti
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.

Mengembalikan nilai

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

Komentar

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 InternetBuka, seperti server proksi yang berbeda yang dikonfigurasi untuk masing-masing.

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.

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

Nota

Header wininet.h mendefinisikan InternetOpen sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

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

Lihat juga

Mengaktifkan Fungsionalitas Internet

Fungsi WinINet

Bagikan melalui