Fungsi WlanCloseHandle (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanCloseHandle menutup koneksi ke server.

Sintaks

DWORD WlanCloseHandle(
  [in] HANDLE hClientHandle,
       PVOID  pReserved
);

Parameter

[in] hClientHandle

Handel sesi klien, yang mengidentifikasi koneksi yang akan ditutup. Handel ini diperoleh dengan panggilan sebelumnya ke fungsi WlanOpenHandle .

pReserved

Disiapkan untuk penggunaan masa mendatang. Atur parameter ini ke NULL.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan mungkin salah satu kode pengembalian berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	hClientHandlenull atau tidak valid, atau pReserved bukan NULL.
ERROR_INVALID_HANDLE	Handel hClientHandle tidak ditemukan dalam tabel handel.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

Setelah koneksi ditutup, setiap upaya penggunaan handel tertutup dapat menyebabkan kesalahan yang tidak terduga. Setelah ditutup, semua pemberitahuan yang beredar akan dibuang.

Jangan panggil WlanCloseHandle dari fungsi panggilan balik. Jika klien berada di tengah panggilan balik pemberitahuan saat WlanCloseHandle dipanggil, fungsi menunggu panggilan balik selesai sebelum mengembalikan nilai. Memanggil fungsi ini di dalam fungsi panggilan balik akan mengakibatkan panggilan tidak pernah selesai. Jika fungsi panggilan balik dan utas yang menutup handel mencoba memperoleh kunci yang sama, kebuntuan dapat terjadi. Selain itu, jangan panggil WlanCloseHandle dari fungsi DllMain dalam DLL aplikasi. Ini juga bisa menyebabkan kebuntuan.

Persyaratan


Klien minimum yang didukung	Windows Vista, Windows XP dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h (termasuk Wlanapi.h)
Pustaka	Wlanapi.lib
DLL	Wlanapi.dll
Redistribusi	API LAN Nirkabel untuk Windows XP dengan SP2

Lihat juga

WlanOpenHandle

Bagikan melalui