Fungsi WlanOpenHandle (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanOpenHandle membuka koneksi ke server.

Sintaks

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Parameter

[in] dwClientVersion

Versi tertinggi WLAN API yang didukung klien.

Nilai	Makna
1	Versi klien untuk Windows XP dengan SP3 dan Wireless LAN API untuk Windows XP dengan SP2.
2	Versi klien untuk Windows Vista dan Windows Server 2008

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

[out] pdwNegotiatedVersion

Versi API WLAN yang akan digunakan dalam sesi ini. Nilai ini biasanya merupakan versi tertinggi yang didukung oleh klien dan server.

[out] phClientHandle

Handel untuk digunakan klien dalam sesi ini. Handel ini digunakan oleh fungsi lain di seluruh sesi.

Nilai kembali

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	pdwNegotiatedVersion adalah NULL, phClientHandle adalah NULL, atau pReserved bukan NULL.
ERROR_NOT_ENOUGH_MEMORY	Gagal mengalokasikan memori untuk membuat konteks klien.
RPC_STATUS	Berbagai kode kesalahan.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	Terlalu banyak handel yang dikeluarkan oleh server.

Keterangan

Nomor versi yang ditentukan oleh dwClientVersion dan pdwNegotiatedVersion adalah nomor versi komposit yang terdiri dari versi utama dan minor. Versi utama ditentukan oleh kata urutan rendah, dan versi minor ditentukan oleh kata urutan tinggi. Makro WLAN_API_VERSION_MAJOR(_v) dan WLAN_API_VERSION_MINOR(_v) mengembalikan nomor versi utama dan minor masing-masing. Anda dapat membuat nomor versi menggunakan makro WLAN_API_MAKE_VERSION(_major, _minor).

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: WlanOpenHandle akan mengembalikan pesan kesalahan jika layanan Wireless Zero Configuration (WZC) belum dimulai atau jika layanan WZC tidak responsif.

Persyaratan


Klien minimum yang didukung	Windows Vista, Windows XP dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h (termasuk Wlanapi.h)
Pustaka	Wlanapi.lib
DLL	Wlanapi.dll
Redistribusi	API LAN Nirkabel untuk Windows XP dengan SP2

Lihat juga

WlanCloseHandle

Bagikan melalui