Edit

WLAN_HOSTED_NETWORK_STATUS structure (wlanapi.h)

  • Article

The WLAN_HOSTED_NETWORK_STATUS structure contains information about the status of the wireless Hosted Network.

Syntax

typedef struct _WLAN_HOSTED_NETWORK_STATUS {
  WLAN_HOSTED_NETWORK_STATE      HostedNetworkState;
  GUID                           IPDeviceID;
  DOT11_MAC_ADDRESS              wlanHostedNetworkBSSID;
  DOT11_PHY_TYPE                 dot11PhyType;
  ULONG                          ulChannelFrequency;
  DWORD                          dwNumberOfPeers;
#if ...
  WLAN_HOSTED_NETWORK_PEER_STATE *PeerList[];
#else
  WLAN_HOSTED_NETWORK_PEER_STATE PeerList[1];
#endif
} WLAN_HOSTED_NETWORK_STATUS, *PWLAN_HOSTED_NETWORK_STATUS;

Members

HostedNetworkState

The current state of the wireless Hosted Network.

If the value of this member is wlan_hosted_network_unavailable, then the values of the other fields in this structure should not be used.

IPDeviceID

The actual network Device ID used for the wireless Hosted Network.

This is member is the GUID of a virtual wireless device which would not be available through calls to the WlanEnumInterfaces function. This GUID can be used for calling other higher layer networking functions that use the device GUID (IP Helper functions, for example).

wlanHostedNetworkBSSID

The BSSID used by the wireless Hosted Network in packets, beacons, and probe responses.

dot11PhyType

The physical type of the network interface used by wireless Hosted Network.

This is one of the types reported by the related physical interface. This value is correct only if the HostedNetworkState member is wlan_hosted_network_active.

ulChannelFrequency

The channel frequency of the network interface used by wireless Hosted Network.

This value is correct only if HostedNetworkState is wlan_hosted_network_active.

dwNumberOfPeers

The current number of authenticated peers on the wireless Hosted Network.

This value is correct only if HostedNetworkState is wlan_hosted_network_active.

PeerList[*]

An array of WLAN_HOSTED_NETWORK_PEER_STATE structures describing each of the current peers on the wireless Hosted Network. The number of elements in the array is given by dwNumberOfPeers member.

This value is correct only if HostedNetworkState is wlan_hosted_network_active.

PeerList[1]

An array of WLAN_HOSTED_NETWORK_PEER_STATE structures describing each of the current peers on the wireless Hosted Network. The number of elements in the array is given by dwNumberOfPeers member.

This value is correct only if HostedNetworkState is wlan_hosted_network_active.

Remarks

The WLAN_HOSTED_NETWORK_STATUS structure is an extension to native wireless APIs added to support the wireless Hosted Network on Windows 7 and later.

The WLAN_HOSTED_NETWORK_STATUS structure is returned in a pointer in the ppWlanHostedNetworkStatus parameter by the WlanHostedNetworkQueryStatus function.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header wlanapi.h (include Wlanapi.h)

See also

DOT11_MAC_ADDRESS

DOT11_PHY_TYPE

WLAN_HOSTED_NETWORK_PEER_STATE

WLAN_HOSTED_NETWORK_STATE

WlanEnumInterfaces

WlanHostedNetworkQueryStatus