Fungsi InternetOpenUrlW (wininet.h)

Artikel
03/08/2023

Membuka sumber daya yang ditentukan oleh FTP lengkap atau URL HTTP.

Sintaks

HINTERNET InternetOpenUrlW(
  [in] HINTERNET hInternet,
  [in] LPCWSTR   lpszUrl,
  [in] LPCWSTR   lpszHeaders,
  [in] DWORD     dwHeadersLength,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Parameter

[in] hInternet

Handel ke sesi Internet saat ini. Handel harus dikembalikan oleh panggilan sebelumnya ke InternetBuka.

[in] lpszUrl

Penunjuk ke variabel string yang dihentikan null yang menentukan URL untuk mulai membaca. Hanya URL yang dimulai dengan ftp:, http:, atau https: yang didukung.

[in] lpszHeaders

Penunjuk ke string yang dihentikan null yang menentukan header yang akan dikirim ke server HTTP. Untuk informasi selengkapnya, lihat deskripsi parameter lpszHeaders dalam fungsi HttpSendRequest .

[in] dwHeadersLength

Ukuran header tambahan, dalam TCHAR. Jika parameter ini adalah -1L dan lpszHeaders bukan NULL, lpszHeaders diasumsikan sebagai zero-terminated (ASCIIZ) dan panjangnya dihitung.

[in] dwFlags

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
INTERNET_FLAG_EXISTING_CONNECT	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. API WinINet menyimpan satu handel koneksi untuk setiap handel HINTERNET yang dihasilkan oleh InternetOpen. InternetOpenUrl menggunakan bendera ini untuk koneksi HTTP dan FTP.
INTERNET_FLAG_HYPERLINK	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.
INTERNET_FLAG_IGNORE_CERT_CN_INVALID	Menonaktifkan pemeriksaan sertifikat berbasis SSL/PCT yang dikembalikan dari server terhadap nama host yang diberikan dalam permintaan. Fungsi WinINet menggunakan pemeriksaan sederhana terhadap sertifikat dengan membandingkan untuk mencocokkan nama host dan aturan wildcard sederhana.
INTERNET_FLAG_IGNORE_CERT_DATE_INVALID	Menonaktifkan pemeriksaan sertifikat berbasis SSL/PCT untuk tanggal validitas yang tepat.
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP	Menonaktifkan deteksi jenis pengalihan khusus ini. Ketika bendera ini digunakan, WinINet secara transparan memungkinkan pengalihan dari HTTPS ke URL HTTP.
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS	Menonaktifkan deteksi jenis pengalihan khusus ini. Ketika bendera ini digunakan, WinINet secara transparan memungkinkan pengalihan dari URL HTTP ke HTTPS.
INTERNET_FLAG_KEEP_CONNECTION	Menggunakan semantik tetap hidup, jika tersedia, untuk koneksi. Bendera ini diperlukan untuk Microsoft Network (MSN), NTLM, dan jenis autentikasi lainnya.
INTERNET_FLAG_NEED_FILE	Menyebabkan file sementara dibuat jika file tidak dapat di-cache.
INTERNET_FLAG_NO_AUTH	Tidak mencoba autentikasi secara otomatis.
INTERNET_FLAG_NO_AUTO_REDIRECT	Tidak secara otomatis menangani pengalihan di HttpSendRequest.
INTERNET_FLAG_NO_CACHE_WRITE	Tidak menambahkan entitas yang dikembalikan ke cache.
INTERNET_FLAG_NO_COOKIES	Tidak secara otomatis menambahkan header cookie ke permintaan, dan tidak secara otomatis menambahkan cookie yang dikembalikan ke database cookie.
INTERNET_FLAG_NO_UI	Menonaktifkan kotak dialog cookie.
INTERNET_FLAG_PASSIVE	Menggunakan semantik FTP pasif. InternetOpenUrl menggunakan bendera ini untuk file dan direktori FTP.
INTERNET_FLAG_PRAGMA_NOCACHE	Memaksa permintaan diselesaikan oleh server asal, bahkan jika salinan cache ada di proksi.
INTERNET_FLAG_RAW_DATA	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. Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Juga mengembalikan data sebagai struktur GOPHER_FIND_DATA saat mengambil informasi direktori Gopher.
INTERNET_FLAG_RELOAD	Memaksa pengunduhan file, objek, atau daftar direktori yang diminta dari server asal, bukan dari cache.
INTERNET_FLAG_RESYNCHRONIZE	Memuat ulang sumber daya HTTP jika sumber daya telah dimodifikasi sejak terakhir kali diunduh. Semua sumber daya FTP dimuat ulang. Windows XP dan Windows Server 2003 R2 dan yang lebih lama: Sumber daya gopher juga dimuat ulang.
INTERNET_FLAG_SECURE	Menggunakan semantik transaksi yang aman. Ini diterjemahkan menggunakan Secure Sockets Layer/Private Communications Technology (SSL/PCT) dan hanya bermakna dalam permintaan HTTP.

[in] dwContext

Penunjuk ke variabel yang menentukan nilai yang ditentukan aplikasi yang diteruskan, bersama dengan handel yang dikembalikan, ke fungsi panggilan balik apa pun.

Nilai kembali

Mengembalikan handel yang valid ke URL jika koneksi berhasil dibuat, atau NULL jika koneksi gagal. Untuk mengambil pesan kesalahan tertentu, panggil GetLastError. Untuk menentukan mengapa akses ke layanan ditolak, hubungi InternetGetLastResponseInfo.

Keterangan

Panggil InternetCanonicalizeUrl terlebih dahulu jika URL yang digunakan berisi URL relatif dan URL dasar yang dipisahkan oleh spasi kosong.

Ini adalah fungsi umum yang dapat digunakan aplikasi untuk mengambil data melalui salah satu protokol yang didukung WinINet. Fungsi ini sangat berguna ketika aplikasi tidak perlu mengakses protokol tertentu, tetapi hanya memerlukan data yang sesuai dengan URL. Fungsi InternetOpenUrl mengurai string URL, membuat koneksi ke server, dan bersiap untuk mengunduh data yang diidentifikasi oleh URL. Aplikasi kemudian dapat menggunakan InternetReadFile (untuk file) atau InternetFindNextFile (untuk direktori) untuk mengambil data URL. Tidak perlu memanggil InternetConnect sebelum InternetOpenUrl.

Windows XP dan Windows Server 2003 R2 dan yang lebih lama: InternetOpenUrl menonaktifkan Gopher pada port kurang dari 1024, kecuali untuk port 70—port Gopher standar—dan port 105—biasanya digunakan untuk pencarian nama Central Services Organization (CSO).

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

Catatan Saat bekerja dalam mode asinkron (parameter dwFlagsInternetOpen menentukan INTERNET_FLAG_ASYNC), dan parameter dwContext adalah nol (INTERNET_NO_CALLBACK), fungsi panggilan balik yang diatur dengan InternetSetStatusCallback pada handel sesi tidak akan dipanggil, namun, panggilan masih akan dilakukan dalam mode asinkron

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 InternetOpenUrl 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

Menangani Pencari Sumber Daya Seragam

Fungsi WinINet

Bagikan melalui