Fungsi InternetCheckConnectionA (wininet.h)

Artikel
08/27/2023

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

Memperbolehkan aplikasi memeriksa apakah sambungan ke Internet dapat dibuat.

Sintaks

BOOL InternetCheckConnectionA(
  [in] LPCSTR 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 ini memaksa koneksi. Koneksi soket dicoba dalam urutan berikut:

Jika lpszUrlnon-NULL, nilai host diekstraksi darinya dan digunakan untuk ping host tertentu.
Jika lpszUrl adalah NULL dan ada entri di database server internal untuk server terdekat, nilai host diekstraksi dari entri dan digunakan untuk ping server tersebut.

[in] dwReserved

Parameter ini dicadangkan dan harus 0.

Nilai kembali

Mengembalikan TRUE jika koneksi berhasil dibuat, atau FALSE jika tidak. 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


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