struktur WLAN_AVAILABLE_NETWORK (wlanapi.h)

Artikel
08/28/2023

Struktur WLAN_AVAILABLE_NETWORK berisi informasi tentang jaringan nirkabel yang tersedia.

Sintaks

typedef struct _WLAN_AVAILABLE_NETWORK {
  WCHAR                  strProfileName[WLAN_MAX_NAME_LENGTH];
  DOT11_SSID             dot11Ssid;
  DOT11_BSS_TYPE         dot11BssType;
  ULONG                  uNumberOfBssids;
  BOOL                   bNetworkConnectable;
  WLAN_REASON_CODE       wlanNotConnectableReason;
  ULONG                  uNumberOfPhyTypes;
  DOT11_PHY_TYPE         dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER];
  BOOL                   bMorePhyTypes;
  WLAN_SIGNAL_QUALITY    wlanSignalQuality;
  BOOL                   bSecurityEnabled;
  DOT11_AUTH_ALGORITHM   dot11DefaultAuthAlgorithm;
  DOT11_CIPHER_ALGORITHM dot11DefaultCipherAlgorithm;
  DWORD                  dwFlags;
  DWORD                  dwReserved;
} WLAN_AVAILABLE_NETWORK, *PWLAN_AVAILABLE_NETWORK;

Anggota

strProfileName[WLAN_MAX_NAME_LENGTH]

Berisi nama profil yang terkait dengan jaringan. Jika jaringan tidak memiliki profil, anggota ini akan kosong. Jika beberapa profil dikaitkan dengan jaringan, akan ada beberapa entri dengan SSID yang sama dalam daftar jaringan yang terlihat. Nama profil peka huruf besar/kecil. String ini harus dihentikan NULL.

dot11Ssid

Struktur DOT11_SSID yang berisi SSID jaringan nirkabel yang terlihat.

dot11BssType

Nilai DOT11_BSS_TYPE yang menentukan apakah jaringan adalah infrastruktur atau ad hoc.

uNumberOfBssids

Menunjukkan jumlah BSSID dalam jaringan.

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: uNumberofBssids paling banyak 1, terlepas dari jumlah titik akses yang menyiarkan SSID.

bNetworkConnectable

Menunjukkan apakah jaringan dapat disambungkan atau tidak. Jika diatur ke TRUE, jaringan dapat disambungkan, jika tidak, jaringan tidak dapat disambungkan.

wlanNotConnectableReason

Nilai WLAN_REASON_CODE yang menunjukkan mengapa jaringan tidak dapat disambungkan. Anggota ini hanya valid ketika bNetworkConnectable adalah FALSE.

uNumberOfPhyTypes

Jumlah jenis PHY yang didukung pada jaringan yang tersedia. Nilai maksimum uNumberOfPhyTypes adalah WLAN_MAX_PHY_TYPE_NUMBER, yang memiliki nilai 8. Jika lebih dari WLAN_MAX_PHY_TYPE_NUMBER jenis PHY didukung, bMorePhyTypes harus diatur ke TRUE.

dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER]

Berisi array nilai DOT11_PHY_TYPE yang mewakili jenis PHY yang didukung oleh jaringan yang tersedia. Ketika uNumberOfPhyTypes lebih besar dari WLAN_MAX_PHY_TYPE_NUMBER, array ini hanya berisi jenis PHY WLAN_MAX_PHY_TYPE_NUMBER pertama.

Nilai	Makna
dot11_phy_type_unknown	Menentukan tipe PHY yang tidak diketahui atau tidak diinisialisasi.
dot11_phy_type_any	Menentukan jenis PHY apa pun.
dot11_phy_type_fhss	Menentukan PHY frekuensi-hopping spread-spectrum (FHSS). Perangkat Bluetooth dapat menggunakan FHSS atau adaptasi FHSS.
dot11_phy_type_dsss	Menentukan PHY sequence spread spectrum (DSSS) langsung.
dot11_phy_type_irbaseband	Menentukan PHY baseband inframerah (IR).
dot11_phy_type_ofdm	Menentukan PHY pembagian frekuensi ortogonal (OFDM). 802.11a perangkat dapat menggunakan OFDM.
dot11_phy_type_hrdsss	Menentukan PHY DSSS (HRDSS) tingkat tinggi.
dot11_phy_type_erp	Menentukan extended rate PHY (ERP). Perangkat 802.11g dapat menggunakan ERP.
dot11_phy_type_ht	Menentukan jenis PHY 802.11n.
dot11_phy_type_vht	Menentukan jenis PHY 802.11ac. Ini adalah jenis PHY throughput yang sangat tinggi yang ditentukan dalam IEEE 802.11ac. Nilai ini didukung pada Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.
dot11_phy_type_IHV_start	Menentukan awal rentang yang digunakan untuk menentukan jenis PHY yang dikembangkan oleh vendor perangkat keras independen (IHV).
dot11_phy_type_IHV_end	Menentukan akhir rentang yang digunakan untuk menentukan jenis PHY yang dikembangkan oleh vendor perangkat keras independen (IHV).

bMorePhyTypes

Menentukan apakah ada lebih dari WLAN_MAX_PHY_TYPE_NUMBER jenis PHY yang didukung.

Ketika anggota ini diatur ke TRUE, aplikasi harus memanggil WlanGetNetworkBssList untuk mendapatkan daftar lengkap jenis PHY. Struktur WLAN_BSS_LIST yang dikembalikan memiliki array struktur WLAN_BSS_ENTRY . Anggota uPhyId dari struktur WLAN_BSS_ENTRY berisi jenis PHY untuk entri.

wlanSignalQuality

Nilai persentase yang mewakili kualitas sinyal jaringan. WLAN_SIGNAL_QUALITY berjenis ULONG. Anggota ini berisi nilai antara 0 dan 100. Nilai 0 menyiratkan kekuatan sinyal RSSI aktual -100 dbm. Nilai 100 menyiratkan kekuatan sinyal RSSI aktual -50 dbm. Anda dapat menghitung nilai kekuatan sinyal RSSI untuk nilai wlanSignalQuality antara 1 dan 99 menggunakan interpolasi linier.

bSecurityEnabled

Menunjukkan apakah keamanan diaktifkan pada jaringan. Nilai TRUE menunjukkan bahwa keamanan diaktifkan, jika tidak, tidak.

dot11DefaultAuthAlgorithm

Nilai DOT11_AUTH_ALGORITHM yang menunjukkan algoritma autentikasi default yang digunakan untuk bergabung dengan jaringan ini untuk pertama kalinya.

dot11DefaultCipherAlgorithm

Nilai DOT11_CIPHER_ALGORITHM yang menunjukkan algoritma sandi default yang akan digunakan saat bergabung dengan jaringan ini.

dwFlags

Berisi berbagai bendera untuk jaringan.

Nilai	Makna
WLAN_AVAILABLE_NETWORK_CONNECTED	Jaringan ini saat ini tersambung.
WLAN_AVAILABLE_NETWORK_HAS_PROFILE	Ada profil untuk jaringan ini.

dwReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

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

WLAN_AVAILABLE_NETWORK_LIST

Bagikan melalui