struktur WLAN_CONNECTION_PARAMETERS (wlanapi.h)

Artikel
12/22/2023

Struktur WLAN_CONNECTION_PARAMETERS menentukan parameter yang digunakan saat menggunakan fungsi WlanConnect .

Sintaks

typedef struct _WLAN_CONNECTION_PARAMETERS {
  WLAN_CONNECTION_MODE wlanConnectionMode;
#if ...
  LPCWSTR              strProfile;
#else
  LPCWSTR              strProfile;
#endif
  PDOT11_SSID          pDot11Ssid;
  PDOT11_BSSID_LIST    pDesiredBssidList;
  DOT11_BSS_TYPE       dot11BssType;
  DWORD                dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;

Anggota

wlanConnectionMode

Nilai WLAN_CONNECTION_MODE yang menentukan mode koneksi.

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: Hanya nilai wlan_connection_mode_profile yang didukung.

strProfile

Menentukan profil yang digunakan untuk koneksi.

Jika wlanConnectionMode diatur ke wlan_connection_mode_profile, maka strProfile menentukan nama profil yang digunakan untuk koneksi. Jika wlanConnectionMode diatur ke wlan_connection_mode_temporary_profile, maka strProfile menentukan representasi XML profil yang digunakan untuk koneksi. Jika wlanConnectionMode diatur ke wlan_connection_mode_discovery_secure atau wlan_connection_mode_discovery_unsecure, maka strProfile harus diatur ke NULL.

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: Profil harus memenuhi kriteria kompatibilitas yang dijelaskan dalam Kompatibilitas Profil Nirkabel.

pDot11Ssid

Penunjuk ke struktur DOT11_SSID yang menentukan SSID jaringan yang akan disambungkan. Parameter ini bersifat opsional. Ketika diatur ke NULL, semua SSID di profil akan dicoba. Parameter ini tidak boleh NULL jika WLAN_CONNECTION_MODE diatur ke wlan_connection_mode_discovery_secure atau wlan_connection_mode_discovery_unsecure.

pDesiredBssidList

Penunjuk ke struktur DOT11_BSSID_LIST yang berisi daftar pengidentifikasi set layanan dasar (BSS) yang diinginkan untuk koneksi.

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: Anggota ini harus NULL.

dot11BssType

Nilai DOT11_BSS_TYPE yang menunjukkan jenis jaringan BSS. Jika profil disediakan, jenis BSS ini harus sama dengan yang ada di profil.

dwFlags

Tabel berikut menunjukkan bendera yang digunakan untuk menentukan parameter koneksi.

Terus-menerus	Nilai	Deskripsi
WLAN_CONNECTION_HIDDEN_NETWORK	0x00000001	Sambungkan ke jaringan tujuan meskipun tujuannya adalah jaringan tersembunyi. Jaringan tersembunyi tidak menyiarkan SSID-nya. Jangan gunakan bendera ini jika jaringan tujuan adalah jaringan ad-hoc. Jika profil yang ditentukan oleh strProfile bukan NULL, maka bendera ini diabaikan dan elemen profil nonBroadcast menentukan apakah akan tersambung ke jaringan tersembunyi.
WLAN_CONNECTION_ADHOC_JOIN_ONLY	0x00000002	Jangan membentuk jaringan ad-hoc. Hanya bergabung dengan jaringan ad-hoc jika jaringan sudah ada. Jangan gunakan bendera ini jika jaringan tujuan adalah jaringan infrastruktur.
WLAN_CONNECTION_IGNORE_PRIVACY_BIT	0x00000004	Abaikan bit privasi ketika menyambungkan ke jaringan. Mengabaikan bit privasi memiliki efek mengabaikan apakah paket dienkripsi dan mengabaikan metode enkripsi yang digunakan. Hanya gunakan bendera ini saat menyambungkan ke jaringan infrastruktur menggunakan profil sementara.
WLAN_CONNECTION_EAPOL_PASSTHROUGH	0x00000008	Mengecualikan lalu lintas EAPOL dari enkripsi dan dekripsi. Bendera ini digunakan ketika aplikasi harus mengirim lalu lintas EAPOL melalui jaringan infrastruktur yang menggunakan autentikasi Terbuka dan enkripsi WEP. Bendera ini tidak boleh digunakan untuk menyambungkan ke jaringan yang memerlukan autentikasi 802.1X. Bendera ini hanya valid ketika wlanConnectionMode diatur ke wlan_connection_mode_temporary_profile. Hindari menggunakan bendera ini jika memungkinkan.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE	0x00000010	Secara otomatis mempertahankan profil penemuan pada penyelesaian koneksi yang berhasil. Bendera ini hanya berlaku untuk wlan_connection_mode_discovery_secure atau wlan_connection_mode_discovery_unsecure. Profil akan disimpan sebagai semua profil pengguna, dengan nama yang dihasilkan dari SSID menggunakan WlanUtf8SsidToDisplayName. Jika sudah ada profil dengan nama yang sama, angka akan ditambahkan ke akhir nama profil. Profil akan disimpan dengan mode koneksi manual, kecuali WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO juga ditentukan.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO	0x00000020	Untuk digunakan bersama dengan WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. Profil penemuan akan dipertahankan dengan mode koneksi otomatis.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING	0x00000040	Untuk digunakan bersama dengan WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. Profil penemuan akan dipertahankan dan mencoba menimpa profil yang ada dengan nama yang sama.

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: Anggota ini harus diatur ke 0.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	wlanapi.h
Redistribusi	API LAN Nirkabel untuk Windows XP dengan SP2

Lihat juga

WlanConnect

Bagikan melalui