Bagikan melalui

struktur WLAN_AVAILABLE_NETWORK (wlanapi.h)

  • Artikel

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