Fungsi WFDCancelOpenSession (wlanapi.h)

Artikel
08/28/2023

Fungsi WFDCancelOpenSession menunjukkan bahwa aplikasi ingin membatalkan fungsi WFDStartOpenSession yang tertunda yang belum selesai.

Sintaks

DWORD WFDCancelOpenSession(
  [in] HANDLE hSessionHandle
);

Parameter

[in] hSessionHandle

Handel sesi ke sesi Wi-Fi Direct untuk dibatalkan. 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.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

Fungsi WFDCancelOpenSession 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.

Panggilan ke fungsi WFDCancelOpenSession memberi tahu layanan Wi-Fi Direct bahwa klien meminta pembatalan sesi ini. Fungsi WFDCancelOpenSession tidak mengubah perilaku WFDStartOpenSession yang diharapkan. Fungsi panggilan balik yang ditentukan untuk fungsi WFDStartOpenSession masih akan dipanggil, dan fungsi WFDStartOpenSession mungkin tidak segera diselesaikan.

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

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