Partager via

WLAN_AVAILABLE_NETWORK (Compact 2013)

  • Article

3/26/2014

This structure contains information about an available wireless network.

Syntax

typedef struct _WLAN_AVAILABLE_NETWORK {
  WCHAR strProfileName[256];
  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;

Members

  • strProfileName
    Contains the profile name associated with the network. If the network does not have a profile, this member is empty. If multiple profiles are associated with the network, multiple entries with the same SSID will reside in the visible network list. Profile names are case-sensitive and the string must be NULL-terminated.
  • dot11Ssid
    A DOT11_SSID structure that contains the SSID of the visible wireless network
  • dot11BssType
    A DOT11_BSS_TYPE value that specifies whether the network is infrastructure or ad hoc.
  • uNumberOfBssids
    Indicates the number of BSSIDs in the network
  • bNetworkConnectable
    Indicates whether the network is connectable or not. If set to TRUE, the network is connectable; otherwise, the network is not connectable.
  • wlanNotConnectableReason
    A WLAN_REASON_CODE value that indicates why a network cannot be connected to. This member is only valid when bNetworkConnectable is FALSE
  • uNumberOfPhyTypes
    The number of PHY types supported on available networks. The maximum value of uNumberOfPhyTypes is WLAN_MAX_PHY_TYPE_NUMBER, which has a value of 8. If more than WLAN_MAX_PHY_TYPE_NUMBER PHY types are supported, bMorePhyTypes must be set to TRUE.

  • dot11PhyTypes
    Contains an array of DOT11_PHY_TYPE values that represent the PHY types supported by the available networks. When uNumberOfPhyTypes is greater than WLAN_MAX_PHY_TYPE_NUMBER, this array contains only the first WLAN_MAX_PHY_TYPE_NUMBER PHY types.

    Value

    Meaning

    dot11_phy_type_unknown

    Specifies an unknown or uninitialized PHY type

    dot11_phy_type_any

    Specifies any PHY type

    dot11_phy_type_fhss

    Specifies a frequency-hopping spread-spectrum (FHSS) PHY. Bluetooth devices can use FHSS or an adaptation of FHSS

    dot11_phy_type_dsss

    Specifies a direct sequence spread spectrum (DSSS) PHY

    dot11_phy_type_ofdm

    Specifies an orthogonal frequency division multiplexing (OFDM) PHY. 802.11a devices can use OFDM

    dot11_phy_type_hrdsss

    Specifies a high-rate DSSS (HRDSSS) PHY

    dot11_phy_type_erp

    Specifies an extended rate PHY (ERP). 802.11g devices can use ERP

    dot11_phy_type_IHV_start

    Specifies the start of the range that is used to define PHY types that are developed by an independent hardware vendor (IHV).

    dot11_phy_type_IHV_end

    Specifies the start of the range that is used to define PHY types that are developed by an independent hardware vendor (IHV).

  • bMorePhyTypes
    Specifies whether more than WLAN_MAX_PHY_TYPE_NUMBER PHY types are supported.

    When this member is set to TRUE, an application must call WlanGetNetworkBssList to retrieve the complete list of PHY types. The returned WLAN_BSS_LIST structure has an array of WLAN_BSS_ENTRY structures. The uPhyId member of the WLAN_BSS_ENTRY structure contains the PHY type for an entry.

  • wlanSignalQuality
    A percentage value that represents the signal quality of the network. WLAN_SIGNAL_QUALITY is of type ULONG. This member contains a value between 0 and 100. A value of 0 implies an actual RSSI signal strength of -100 dbm. A value of 100 implies an actual RSSI signal strength of -50 dbm. You can calculate the RSSI signal strength value for wlanSignalQuality values between 1 and 99 by using linear interpolation.
  • bSecurityEnabled
    Indicates whether security is enabled on the network. A value of TRUE indicates that security is enabled; otherwise, it is not enabled.
  • dot11DefaultAuthAlgorithm
    A DOT11_AUTH_ALGORITHM value that indicates the default authentication algorithm that is used to join this network for the first time.
  • dot11DefaultCipherAlgorithm
    A DOT11_CIPHER_ALGORITHM value that indicates the default cipher algorithm to be used when joining this network.

  • dwFlags
    Contains various flags for the network:

    Value

    Meaning

    WLAN_AVAILABLE_NETWORK_CONNECTED

    This network is currently connected

    WLAN_AVAILABLE_NETWORK_HAS_PROF

    A profile exists for this network
  • dwReserved
    Reserved for future use. Must be set to NULL.

See Also

Reference

Native Wi-Fi Structures
DOT11_SSID
DOT11_BSS_TYPE
DOT11_PHY_TYPE
WlanGetNetworkBssList
WLAN_BSS_LIST
WLAN_BSS_ENTRY
DOT11_AUTH_ALGORITHM
WLAN_AVAILABLE_NETWORK_LIST
Native Wi-Fi Reference