Fungsi InternetCheckConnectionW (wininet.h)

Artikel
08/27/2023

[InternetCheckConnection tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan NetworkInformation.GetInternetConnectionProfile atau Antarmuka NLM. ]

Memungkinkan aplikasi memeriksa apakah sambungan ke Internet dapat dibuat.

Sintaks

BOOL InternetCheckConnectionW(
  [in] LPCWSTR lpszUrl,
  [in] DWORD   dwFlags,
  [in] DWORD   dwReserved
);

Parameter

[in] lpszUrl

Penunjuk ke string yang dihentikan null yang menentukan URL yang akan digunakan untuk memeriksa koneksi. Nilai ini bisa NULL.

[in] dwFlags

Opsi. FLAG_ICC_FORCE_CONNECTION adalah satu-satunya bendera yang saat ini tersedia. Jika bendera ini diatur, bendera akan memaksa koneksi. Koneksi soket dicoba dalam urutan berikut:

Jika lpszUrlnon-NULL, nilai host diekstrak darinya dan digunakan untuk ping host tertentu.
Jika lpszUrladalah NULL dan ada entri dalam database server internal untuk server terdekat, nilai host diekstrak dari entri dan digunakan untuk ping server tersebut.

[in] dwReserved

Parameter ini dicadangkan dan harus 0.

Mengembalikan nilai

Mengembalikan TRUE jika koneksi berhasil dibuat, atau FALSE sebaliknya. Gunakan GetLastError untuk mengambil kode kesalahan. ERROR_NOT_CONNECTED dikembalikan oleh GetLastError jika koneksi tidak dapat dibuat atau jika database soket offline tanpa syarat.

Keterangan

InternetCheckConnection tidak digunakan lagi. InternetCheckConnection tidak berfungsi di lingkungan yang menggunakan server proksi web untuk mengakses Internet. Bergantung pada lingkungan, gunakan NetworkInformation.GetInternetConnectionProfile atau Antarmuka NLM untuk memeriksa akses Internet sebagai gantinya.

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