Bagikan melalui

Fungsi WlanDisconnect (wlanapi.h)

  • Artikel

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