estrutura WLAN_HOSTED_NETWORK_STATUS (wlanapi.h)

Artigo
08/28/2023

A estrutura WLAN_HOSTED_NETWORK_STATUS contém informações sobre o status da Rede Hospedada sem fio.

Sintaxe

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;

Membros

HostedNetworkState

O estado atual da Rede Hospedada sem fio.

Se o valor desse membro for wlan_hosted_network_unavailable, os valores dos outros campos nessa estrutura não deverão ser usados.

IPDeviceID

A ID real do dispositivo de rede usada para a rede hospedada sem fio.

Esse membro é o GUID de um dispositivo sem fio virtual que não estaria disponível por meio de chamadas para a função WlanEnumInterfaces . Esse GUID pode ser usado para chamar outras funções de rede de camada superior que usam o GUID do dispositivo (funções auxiliares de IP, por exemplo).

wlanHostedNetworkBSSID

O BSSID usado pela rede hospedada sem fio em pacotes, sinalizadores e respostas de investigação.

dot11PhyType

O tipo físico do adaptador de rede usado pela rede hospedada sem fio.

Esse é um dos tipos relatados pela interface física relacionada. Esse valor só estará correto se o membro HostedNetworkState for wlan_hosted_network_active.

ulChannelFrequency

A frequência de canal do adaptador de rede usado pela rede hospedada sem fio.

Esse valor só estará correto se HostedNetworkState for wlan_hosted_network_active.

dwNumberOfPeers

O número atual de pares autenticados na Rede Hospedada sem fio.

Esse valor só estará correto se HostedNetworkState for wlan_hosted_network_active.

PeerList[*]

Uma matriz de estruturas WLAN_HOSTED_NETWORK_PEER_STATE que descrevem cada um dos pares atuais na Rede Hospedada sem fio. O número de elementos na matriz é fornecido pelo membro dwNumberOfPeers .

Esse valor só estará correto se HostedNetworkState for wlan_hosted_network_active.

PeerList[1]

Esse valor só estará correto se HostedNetworkState for wlan_hosted_network_active.

Comentários

A estrutura WLAN_HOSTED_NETWORK_STATUS é uma extensão para APIs sem fio nativas adicionadas para dar suporte à Rede Hospedada sem fio no Windows 7 e posterior.

A estrutura WLAN_HOSTED_NETWORK_STATUS é retornada em um ponteiro no parâmetro ppWlanHostedNetworkStatus pela função WlanHostedNetworkQueryStatus .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho	wlanapi.h (inclua Wlanapi.h)