Fungsi WFDCloseSession (wlanapi.h)

Artikel
03/04/2024

Fungsi WFDCloseSession menutup sesi setelah panggilan yang berhasil sebelumnya ke fungsi WFDStartOpenSession .

Sintaks

DWORD WFDCloseSession(
  [in] HANDLE hSessionHandle
);

Parameter

[in] hSessionHandle

Handel sesi ke sesi Wi-Fi Direct. Ini adalah handel sesi yang sebelumnya dikembalikan oleh fungsi WFDStartOpenSession .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

Menampilkan kode	Deskripsi
ERROR_INVALID_HANDLE	Handel tidak valid. Kesalahan ini dikembalikan jika handel yang ditentukan dalam parameter hSessionHandle tidak ditemukan dalam tabel handel.
ERROR_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika parameter hSessionHandleadalah NULL atau tidak valid.
ERROR_INVALID_STATE	Grup atau sumber daya tidak dalam status yang benar untuk melakukan operasi yang diminta. Kesalahan ini dikembalikan jika layanan Wi-Fi Direct dinonaktifkan oleh kebijakan grup pada domain.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

Fungsi WFDCloseSession adalah bagian dari Wi-Fi Direct, fitur baru di Windows 8 dan Windows Server 2012. Wi-Fi Direct didasarkan pada pengembangan Spesifikasi Teknis Peer-to-Peer Wi-Fi v1.1 oleh Aliansi Wi-Fi (lihat Spesifikasi yang Diterbitkan Aliansi Wi-Fi). Tujuan dari Wi-Fi Spesifikasi Teknis Peer-to-Peer adalah untuk memberikan solusi untuk konektivitas perangkat-ke-perangkat Wi-Fi tanpa perlu Wireless Access Point (AP nirkabel) untuk mengatur koneksi atau penggunaan mekanisme Wi-Fi adhoc (IBSS) yang ada.

Fungsi WFDCloseSession mengantrekan item kerja di masa mendatang untuk menutup sesi, sehingga pemutusan sambungan mungkin tidak segera.

Memanggil fungsi WFDCloseSession sementara panggilan WFDStartOpenSession tertunda tidak akan menutup sesi.

Penelepon bertanggung jawab untuk meneruskan fungsi WFDCloseSession handel dalam parameter hSessionHandle yang dikembalikan dari panggilan asinkron yang berhasil ke fungsi WFDStartOpenSession .

Memanggil fungsi WFDCloseSession dengan handel yang valid dan menjadi tidak valid akan menghasilkan hasil yang tidak terdefinisi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h
Pustaka	Wlanapi.lib
DLL	Wlanapi.dll