Fungsi WFDOpenHandle (wlanapi.h)

Artikel
03/13/2024

Fungsi WFDOpenHandle membuka handel ke layanan Wi-Fi Direct dan menegosiasikan versi API Langsung Wi-FI untuk digunakan.

Sintaks

DWORD WFDOpenHandle(
  [in]  DWORD   dwClientVersion,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Parameter

[in] dwClientVersion

Versi tertinggi Wi-Fi Direct API yang didukung klien.

Untuk Windows 8 dan Windows Server 2012, parameter ini harus diatur ke WFD_API_VERSION, konstanta yang ditentukan dalam file header Wlanapi.h.

[out] pdwNegotiatedVersion

Pointer ke DWORD untuk menerima versi yang dinegosiasikan.

Jika fungsi WFDOpenHandle berhasil, versi yang dinegosiasikan dengan Layanan Langsung Wi-Fi yang akan digunakan oleh sesi ini dikembalikan. Nilai ini biasanya merupakan versi tertinggi yang didukung oleh klien dan layanan Wi-Fi Direct.

[out] phClientHandle

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

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

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_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika parameter pdwNegotiatedVersion adalah NULL atau parameter phClientHandle adalah NULL. Nilai ini juga dikembalikan jika parameter dwClientVersion tidak sama dengan WFD_API_VERSION.
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.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	Upaya dilakukan untuk membuat sesi ke server jaringan, tetapi sudah ada terlalu banyak sesi yang ditetapkan ke server tersebut. Kesalahan ini dikembalikan jika terlalu banyak handel telah dikeluarkan oleh layanan Wi-Fi Direct.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

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

Untuk menggunakan Wi-Fi Direct, aplikasi harus terlebih dahulu mendapatkan handel ke layanan Wi-Fi Direct dengan memanggil fungsi WFDOpenHandle . Handel Wi-Fi Direct (WFD) yang dikembalikan oleh fungsi WFDOpenHandle digunakan untuk panggilan berikutnya yang dilakukan ke layanan Wi-Fi Direct. Setelah aplikasi selesai menggunakan layanan Wi-Fi Direct, aplikasi harus 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