Fungsi InternetOpenUrlA (wininet.h)

  • Artikel

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

Sintaks

HINTERNET InternetOpenUrlA(
  [in] HINTERNET hInternet,
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    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 wildcarding 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 yang di-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.

Mengembalikan nilai

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 bagian dari protokol, 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