Fungsi InternetCloseHandle (wininet.h)

Artikel
08/27/2023

Menutup satu handel Internet.

Sintaks

BOOL InternetCloseHandle(
  [in] HINTERNET hInternet
);

Parameter

[in] hInternet

Handel untuk ditutup.

Menampilkan nilai

Mengembalikan TRUE jika handel berhasil ditutup, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi mengakhiri operasi yang tertunda pada handel dan membuang data yang luar biasa.

Anda dapat memanggil InternetCloseHandle selama tidak ada panggilan API yang dilakukan atau akan dilakukan menggunakan handel. Setelah API kembali ERROR_IO_PENDING, aman untuk memanggil InternetCloseHandle untuk membatalkan I/O tersebut, selama tidak ada panggilan API berikutnya yang akan dikeluarkan dengan handel.

Sangat aman untuk memanggil InternetCloseHandle dalam panggilan balik untuk handel yang ditutup. Jika ada panggilan balik status yang terdaftar untuk handel yang ditutup, dan handel dibuat dengan nilai konteks non-NULL, panggilan balik INTERNET_STATUS_HANDLE_CLOSING akan dilakukan. Indikasi ini akan menjadi panggilan balik terakhir yang dibuat dari handel dan menunjukkan bahwa handel sedang dihancurkan.

Jika permintaan asinkron tertunda untuk handel atau handel turunannya, handel tidak dapat segera ditutup, tetapi akan dibatalkan. Setiap permintaan baru yang dicoba menggunakan handel akan kembali dengan pemberitahuan ERROR_INVALID_HANDLE . Permintaan asinkron akan selesai dengan INTERNET_STATUS_REQUEST_COMPLETE. Aplikasi harus siap untuk menerima indikasi INTERNET_STATUS_REQUEST_COMPLETE pada handel sebelum indikasi INTERNET_STATUS_HANDLE_CLOSING akhir dibuat, yang menunjukkan bahwa handel sepenuhnya tertutup.

Aplikasi dapat memanggil GetLastError untuk menentukan apakah permintaan tertunda. Jika GetLastError mengembalikan ERROR_IO_PENDING, ada permintaan yang luar biasa saat handel ditutup.

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).

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