Fungsi WFDStartOpenSession (wlanapi.h)

Artikel
12/22/2023

Fungsi WFDStartOpenSession memulai koneksi sesuai permintaan ke perangkat Wi-Fi Direct tertentu, yang sebelumnya telah dipasangkan melalui pengalaman Pemasangan Windows.

Sintaks

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

Parameter

[in] hClientHandle

Klien menangani layanan Wi-Fi Direct. Handel ini diperoleh dengan panggilan sebelumnya ke fungsi WFDOpenHandle .

[in] pDeviceAddress

Penunjuk ke alamat perangkat Wi-Fi Direct perangkat target. Ini adalah alamat MAC perangkat Wi-Fi target.

[in, optional] pvContext

Penunjuk konteks opsional yang diteruskan ke fungsi panggilan balik yang ditentukan dalam parameter pfnCallback .

[in] pfnCallback

Penunjuk ke fungsi panggilan balik yang akan dipanggil setelah permintaan WFDStartOpenSession selesai.

[out] phSessionHandle

Handel ke sesi Wi-Fi Direct khusus ini.

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 hClientHandle tidak ditemukan dalam tabel handel.
ERROR_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika parameter hClientHandleadalah NULL atau tidak valid. Kesalahan ini juga dikembalikan jika parameter pDeviceAddress adalah NULL, parameter pfnCallback adalah NULL, atau parameter phSessionHandle adalah NULL. Nilai ini juga dikembalikan jika parameter dwClientVersion tidak sama dengan WFD_API_VERSION.
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 kode kesalahan.

Keterangan

Fungsi WFDStartOpenSession 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 WFDStartOpenSession memulai operasi asinkron untuk memulai koneksi sesuai permintaan ke perangkat Wi-Fi Direct tertentu. Perangkat Wi-Fi target sebelumnya harus dipasangkan melalui pengalaman Pemasangan Windows. Ketika operasi asinkron selesai, fungsi panggilan balik yang ditentukan dalam parameter pfnCallback dipanggil.

Jika aplikasi mencoba menutup handel ke layanan Wi-Fi Direct dengan memanggil fungsi WFDCloseHandle sebelum fungsi WFDStartOpenSession selesai secara asinkron, fungsi WFDCloseHandle akan menunggu hingga panggilan WFDStartOpenSession selesai.

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