Compartilhar via

estrutura WLAN_CONNECTION_PARAMETERS (wlanapi.h)

  • Artigo

A estrutura WLAN_CONNECTION_PARAMETERS especifica os parâmetros usados ao usar a função WlanConnect .

Sintaxe

typedef struct _WLAN_CONNECTION_PARAMETERS {
  WLAN_CONNECTION_MODE wlanConnectionMode;
#if ...
  LPCWSTR              strProfile;
#else
  LPCWSTR              strProfile;
#endif
  PDOT11_SSID          pDot11Ssid;
  PDOT11_BSSID_LIST    pDesiredBssidList;
  DOT11_BSS_TYPE       dot11BssType;
  DWORD                dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;

Membros

wlanConnectionMode

Um valor WLAN_CONNECTION_MODE que especifica o modo de conexão.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Há suporte apenas para o valor wlan_connection_mode_profile .

strProfile

Especifica o perfil que está sendo usado para a conexão.

Se wlanConnectionMode estiver definido como wlan_connection_mode_profile, strProfile especificará o nome do perfil usado para a conexão. Se wlanConnectionMode for definido como wlan_connection_mode_temporary_profile, strProfile especificará a representação XML do perfil usado para a conexão. Se wlanConnectionMode estiver definido como wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure, strProfile deverá ser definido como NULL.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: O perfil deve atender aos critérios de compatibilidade descritos em Compatibilidade de perfil sem fio.

pDot11Ssid

Ponteiro para uma estrutura DOT11_SSID que especifica o SSID da rede à qual se conectar. Esse parâmetro é opcional. Quando definido como NULL, todos os SSIDs no perfil serão testados. Esse parâmetro não deverá ser NULL se WLAN_CONNECTION_MODE estiver definido como wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure.

pDesiredBssidList

Ponteiro para uma estrutura DOT11_BSSID_LIST que contém a lista de identificadores BSS (conjunto de serviços básicos) desejados para a conexão.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Esse membro deve ser NULL.

dot11BssType

Um valor DOT11_BSS_TYPE que indica o tipo BSS da rede. Se um perfil for fornecido, esse tipo BSS deverá ser o mesmo que o do perfil.

dwFlags

A tabela a seguir mostra os sinalizadores usados para especificar os parâmetros de conexão.

Constante Valor Descrição
WLAN_CONNECTION_HIDDEN_NETWORK 0x00000001 Conecte-se à rede de destino mesmo que o destino seja uma rede oculta. Uma rede oculta não transmite seu SSID. Não use esse sinalizador se a rede de destino for uma rede ad hoc. Se o perfil especificado por strProfile não for NULL, esse sinalizador será ignorado e o elemento de perfil nonBroadcast determinará se deve se conectar a uma rede oculta.
WLAN_CONNECTION_ADHOC_JOIN_ONLY 0x00000002 Não forme uma rede ad hoc. Ingresse apenas em uma rede ad hoc se a rede já existir. Não use esse sinalizador se a rede de destino for uma rede de infraestrutura.
WLAN_CONNECTION_IGNORE_PRIVACY_BIT 0x00000004 Ignore o bit de privacidade ao se conectar à rede. Ignorar o bit de privacidade tem o efeito de ignorar se os pacotes são criptografados e ignorar o método de criptografia usado. Use esse sinalizador somente ao se conectar a uma rede de infraestrutura usando um perfil temporário.
WLAN_CONNECTION_EAPOL_PASSTHROUGH 0x00000008 Isente o tráfego EAPOL da criptografia e descriptografia. Esse sinalizador é usado quando um aplicativo deve enviar tráfego EAPOL por uma rede de infraestrutura que usa autenticação aberta e criptografia WEP. Esse sinalizador não deve ser usado para se conectar a redes que exigem autenticação 802.1X. Esse sinalizador só é válido quando wlanConnectionMode é definido como wlan_connection_mode_temporary_profile. Evite usar esse sinalizador sempre que possível.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE 0x00000010 Persista automaticamente o perfil de descoberta na conclusão bem-sucedida da conexão. Esse sinalizador só é válido para wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure. O perfil será salvo como um perfil de usuário inteiro, com o nome gerado do SSID usando WlanUtf8SsidToDisplayName. Se já houver um perfil com o mesmo nome, um número será acrescentado ao final do nome do perfil. O perfil será salvo com o modo de conexão manual, a menos que WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO também seja especificado.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO 0x00000020 Para ser usado em conjunto com WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. O perfil de descoberta será persistido com o modo de conexão automática.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING 0x00000040 Para ser usado em conjunto com WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. O perfil de descoberta será persistido e tentará substituir um perfil existente com o mesmo nome.
 

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Esse membro deve ser definido como 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho wlanapi.h
Redistribuível API de LAN sem fio para Windows XP com SP2

Confira também

WlanConnect