Bagikan melalui

struktur WLAN_CONNECTION_PARAMETERS (wlanapi.h)

  • Artikel

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