Fungsi WFDOpenLegacySession (wlanapi.h)

Artikel
12/22/2023

Fungsi WFDOpenLegacySession mengambil dan menerapkan profil tersimpan untuk perangkat warisan Wi-Fi Direct.

Sintaks

DWORD WFDOpenLegacySession(
  HANDLE             hClientHandle,
  PDOT11_MAC_ADDRESS pLegacyMacAddress,
  HANDLE             *phSessionHandle,
  GUID               *pGuidSessionInterface
);

Parameter

hClientHandle

HANDLE ke layanan Wi-Fi Direct untuk sesi ini. Parameter ini diambil menggunakan fungsi WFDOpenHandle .

pLegacyMacAddress

Penunjuk ke Wi-Fi Alamat perangkat langsung dari perangkat klien warisan.

phSessionHandle

Penunjuk ke HANDLE untuk menerima handel ke layanan Wi-Fi Direct untuk sesi ini.

Jika fungsi WFDOpenLegacySession berhasil, handel ke layanan Wi-Fi Direct untuk digunakan dalam sesi ini dikembalikan.

pGuidSessionInterface

Penunjuk ke GUID antarmuka jaringan untuk sesi ini.

Jika fungsi WFDOpenLegacySession berhasil, GUID antarmuka jaringan tempat sesi Wi-Fi Direct dikembalikan.

Mengembalikan nilai

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	Parameter salah. Kesalahan ini dikembalikan jika phClientHandle atau parameter pLegacyMacAddress adalah NULL.
ERROR_NOT_ENOUGH_MEMORY	Penyimpanan tidak cukup tersedia untuk memproses perintah ini. Kesalahan ini dikembalikan jika sistem tidak dapat mengalokasikan memori untuk membuat konteks klien.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

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

Untuk menggunakan Wi-Fi Direct, aplikasi harus terlebih dahulu mendapatkan handel ke layanan Wi-Fi Direct dengan memanggil fungsi WFDOpenLegacySession atau WFDOpenHandle . Handel Wi-Fi Direct (WFD) yang dikembalikan oleh fungsi WFDOpenHandle digunakan untuk panggilan berikutnya yang dilakukan ke layanan Wi-Fi Direct. Fungsi WFDOpenLegacySession digunakan untuk mengambil dan menerapkan profil tersimpan untuk perangkat warisan Wi-Fi Direct.

Fungsi WFDOpenLegacySession mengambil profil warisan yang disimpan untuk perangkat dari penyimpanan profil untuk alamat perangkat warisan yang ditentukan. Alamat perangkat ini harus diperoleh dari Simpul Perangkat yang dibuat sebagai hasil dari pengalaman pemasangan Kotak Masuk (Pemasangan WPS Warisan).

Setelah aplikasi dilakukan menggunakan layanan Wi-Fi Direct, aplikasi harus memanggil fungsi WFDCloseSession untuk menutup sesi dan memanggil fungsi WFDCloseHandle untuk memberi sinyal ke layanan Wi-Fi Direct bahwa aplikasi dilakukan menggunakan layanan. Ini memungkinkan layanan Wi-Fi Direct untuk merilis sumber daya yang digunakan oleh aplikasi.

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