Fungsi WlanDisconnect (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanDisconnect memutuskan sambungan antarmuka dari jaringannya saat ini.

Sintaks

DWORD WlanDisconnect(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
       PVOID      pReserved
);

Parameter

[in] hClientHandle

Handel sesi klien, diperoleh dengan panggilan sebelumnya ke fungsi WlanOpenHandle .

[in] pInterfaceGuid

GUID antarmuka yang akan diputus.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

Nilai kembali

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, pInterfaceGuid adalah NULL, atau pReserved bukan NULL.
ERROR_INVALID_HANDLE	Handel hClientHandle tidak ditemukan dalam tabel handel.
RPC_STATUS	Berbagai kode kesalahan.
ERROR_NOT_ENOUGH_MEMORY	Gagal mengalokasikan memori untuk hasil kueri.
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai.

Keterangan

Ketika koneksi dibuat menggunakan WlanConnect, profil ditentukan oleh anggota strProfile dari struktur WLAN_CONNECTION_PARAMETERS yang ditunjukkan oleh pConnectionParameters. Jika profil tersebut adalah profil semua pengguna, pemanggil WlanDisconnect harus memiliki akses eksekusi pada profil. Jika tidak, panggilan WlanDisconnect akan gagal dengan nilai yang dikembalikan ERROR_ACCESS_DENIED. Izin pada profil semua pengguna dibuat saat profil dibuat atau disimpan menggunakan WlanSetProfile atau WlanSaveTemporaryProfile.

Untuk melakukan operasi pemutusan sambungan pada baris perintah, gunakan perintah netsh wlan disconnect . Untuk informasi selengkapnya, lihat Perintah Netsh untuk Jaringan Area Lokal Nirkabel (wlan).

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: WlanDisconnect memiliki efek samping memodifikasi profil yang terkait dengan jaringan yang terputus. Profil jaringan menjadi profil sesuai permintaan setelah panggilan WlanDisconnect . Layanan Konfigurasi Nol Nirkabel tidak akan tersambung secara otomatis ke jaringan dengan profil sesuai permintaan ketika jaringan berada dalam rentang. Jangan panggil WlanDisconnect sebelum memanggil WlanConnect kecuali Anda ingin mengubah profil ke profil sesuai permintaan. Ketika Anda memanggil WlanConnect untuk membuat koneksi jaringan, koneksi jaringan yang ada akan terputus secara otomatis.

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

WlanConnect

Bagikan melalui