Fungsi WinHttpCloseHandle (winhttp.h)

Artikel
03/15/2023

Fungsi WinHttpCloseHandle menutup satu handel HINTERNET (lihat Handel HINTERNET di WinHTTP).

Sintaks

WINHTTPAPI BOOL WinHttpCloseHandle(
  [in] HINTERNET hInternet
);

Parameter

[in] hInternet

Handel HINTERNET yang valid (lihat Handel HINTERNET di WinHTTP) untuk ditutup.

Nilai kembali

TRUE jika handel berhasil ditutup, jika tidak FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Di antara kode kesalahan yang dikembalikan adalah sebagai berikut.

Kode Kesalahan	Deskripsi
ERROR_WINHTTP_SHUTDOWN	Dukungan fungsi WinHTTP sedang dimatikan atau dibongkar.
ERROR_WINHTTP_INTERNAL_ERROR	Terjadi kesalah internal.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia untuk menyelesaikan operasi yang diminta. (Kode galat Windows)

Keterangan

Bahkan ketika WinHTTP digunakan dalam mode asinkron (yaitu, ketika WINHTTP_FLAG_ASYNC telah diatur di WinHttpOpen), fungsi ini beroperasi secara sinkron. Nilai yang dikembalikan menunjukkan keberhasilan atau kegagalan. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Jika ada panggilan balik status yang terdaftar untuk handel yang ditutup dan handel dibuat dengan nilai konteks non-NULL , panggilan balik WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING dilakukan. Ini adalah panggilan balik terakhir yang dibuat dari handel dan menunjukkan bahwa handel sedang dihancurkan.

Aplikasi dapat mengakhiri permintaan asinkron yang sedang berlangsung dengan menutup handel permintaan HINTERNET menggunakan WinHttpCloseHandle. Ingatlah hal-hal berikut:

Setelah aplikasi memanggil WinHttpCloseHandle pada handel WinHTTP, aplikasi tidak dapat memanggil fungsi WinHTTP API lainnya menggunakan handel tersebut dari utas apa pun.
Bahkan setelah panggilan ke WinHttpCloseHandle kembali, aplikasi masih harus siap untuk menerima panggilan balik untuk handel tertutup, karena WinHTTP dapat merobek handel secara asinkron. Jika permintaan asinkron tidak berhasil diselesaikan, panggilan balik akan menerima pemberitahuan WINHTTP_CALLBACK_STATUS_REQUEST_ERROR.
Jika aplikasi mengaitkan struktur data konteks atau objek dengan handel, aplikasi harus mempertahankan pengikatan tersebut hingga fungsi panggilan balik menerima pemberitahuan WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING . Ini adalah pemberitahuan panggilan balik terakhir yang dikirim WinHTTP sebelum menghapus objek handel dari memori. Untuk menerima pemberitahuan panggilan balik WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING , aplikasi harus mengaktifkan bendera WINHTTP_CALLBACK_FLAG_HANDLES dalam panggilan WinHttpSetStatusCallback .
Sebelum memanggil WinHttpCloseHandle, aplikasi dapat memanggil WinHttpSetStatusCallback untuk menunjukkan bahwa tidak ada lagi panggilan balik yang harus dilakukan:
WinHttpSetStatusCallback( hRequest, NULL, 0, 0 );

Mungkin tampak bahwa struktur data konteks kemudian dapat segera dikosongkan daripada harus menunggu pemberitahuan WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING , tetapi ini tidak terjadi: WinHTTP tidak menyinkronkan WinHttpSetStatusCallback dengan panggilan balik yang berasal dari utas pekerja. Akibatnya, panggilan balik sudah dapat berlangsung dari utas lain, dan aplikasi dapat menerima pemberitahuan panggilan balik bahkan setelah NULL mengeluarkan penunjuk fungsi panggilan balik dan menghapus struktur data konteks handel. Karena kondisi balapan yang potensial ini, konservatiflah dalam membebaskan struktur konteks sampai setelah menerima pemberitahuan WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING .

Aplikasi tidak boleh memanggil WinHttpCloseHandle pada permintaan sinkron. Ini dapat menciptakan kondisi balapan. Lihat Handel HINTERNET di WinHTTP untuk informasi selengkapnya.

Catatan Untuk Windows XP dan Windows 2000, lihat bagian Persyaratan Run-Time di halaman mulai WinHttp.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003, Windows 2000 Server dengan SP3 [hanya aplikasi desktop]
Target Platform	Windows
Header	winhttp.h
Pustaka	Winhttp.lib
DLL	Winhttp.dll
Redistribusi	WinHTTP 5.0 dan Internet Explorer 5.01 atau yang lebih baru pada Windows XP dan Windows 2000.