WFD_OPEN_SESSION_COMPLETE_CALLBACK fungsi panggilan balik (wlanapi.h)

Artikel
03/04/2024

Fungsi WFD_OPEN_SESSION_COMPLETE_CALLBACK menentukan fungsi panggilan balik yang dipanggil oleh fungsi WFDStartOpenSession ketika operasi WFDStartOpenSession selesai.

Sintaks

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

Parameter

[in] hSessionHandle

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

[in] pvContext

Penunjuk konteks diteruskan ke fungsi panggilan balik dari fungsi WFDStartOpenSession .

[in] guidSessionInterface

GUID antarmuka antarmuka jaringan lokal tempat perangkat Wi-Fi Direct ini memiliki sesi terbuka. Parameter ini berguna jika protokol lapisan yang lebih tinggi perlu menentukan antarmuka jaringan mana yang terikat dengan sesi Wi-Fi Direct. Nilai ini hanya dikembalikan jika parameter dwError ERROR_SUCCESS.

[in] dwError

Nilai yang menentukan apakah ada kesalahan yang ditemui selama panggilan ke fungsi WFDStartOpenSession . Jika nilai ini ERROR_SUCCESS, maka tidak ada kesalahan yang terjadi dan operasi untuk membuka sesi berhasil diselesaikan.

Nilai lain berikut ini dimungkinkan:

Nilai	Makna
ERROR_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika parameter hClientHandleNULL 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.
ERROR_SERVICE_NOT_ACTIVE	Layanan belum dimulai. Kesalahan ini dikembalikan jika Layanan Konfigurasi Otomatis WLAN tidak berjalan.
RPC_STATUS	Berbagai RPC dan kode kesalahan lainnya. Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

[in] dwReasonCode

Nilai yang menentukan detail selengkapnya jika terjadi kesalahan selama WFDStartOpenSession.

Mengembalikan nilai

Tidak ada

Keterangan

Fungsi WFD_OPEN_SESSION_COMPLETE_CALLBACK 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 Wi-Fi konektivitas perangkat-ke-perangkat tanpa perlu Titik Akses Nirkabel (AP nirkabel) untuk mengatur koneksi atau penggunaan mekanisme Wi-Fi adhoc (IBSS) yang ada.

Fungsi WFDStartOpenSession memulai operasi asinkron untuk memulai koneksi sesuai permintaan ke perangkat Wi-Fi Direct tertentu. Perangkat Wi-Fi target sebelumnya harus dipasangkan melalui pengalaman Windows Pairing. Ketika operasi asinkron untuk membuat koneksi Wi-FI Direct selesai, fungsi panggilan balik yang ditentukan dalam parameter pfnCallback dipanggil.

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