Compartilhar via

Função WlanConnect (wlanapi.h)

  • Artigo

A função WlanConnect tenta se conectar a uma rede específica.

Sintaxe

DWORD WlanConnect(
  [in] HANDLE                            hClientHandle,
  [in] const GUID                        *pInterfaceGuid,
  [in] const PWLAN_CONNECTION_PARAMETERS pConnectionParameters,
       PVOID                             pReserved
);

Parâmetros

[in] hClientHandle

O identificador de sessão do cliente, retornado por uma chamada anterior para a função WlanOpenHandle .

[in] pInterfaceGuid

O GUID da interface a ser usada para a conexão.

[in] pConnectionParameters

Ponteiro para uma estrutura WLAN_CONNECTION_PARAMETERS que especifica o tipo de conexão, o modo, o perfil de rede, o SSID que identifica a rede e outros parâmetros.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Há algumas restrições nos membros do WLAN_CONNECTION_PARAMETERS . Isso significa que as estruturas válidas para Windows Server 2008 e Windows Vista podem não ser válidas para o Windows XP com SP3 ou API lan sem fio para Windows XP com SP2. Para obter uma lista de restrições, consulte WLAN_CONNECTION_PARAMETERS.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de retorno.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Uma das seguintes condições ocorreu:
  • hClientHandle é NULL ou inválido.
  • pInterfaceGuid é NULL.
  • pConnectionParameters é NULL.
  • O membro dwFlags da estrutura apontada por pConnectionParameters não está definido como um dos valores especificados na página WLAN_CONNECTION_PARAMETERS .
  • O membro wlanConnectionMode da estrutura apontada por pConnectionParameters é definido como wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure e o membro pDot11Ssid da mesma estrutura é NULL.
  • O membro wlanConnectionMode da estrutura apontada por pConnectionParameters é definido como wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure e o membro dot11BssType da mesma estrutura é definido como dot11_BSS_type_any.
  • O membro wlanConnectionMode da estrutura apontada por pConnectionParameters é definido como wlan_connection_mode_profile e o membro strProfile da mesma estrutura é NULL ou o comprimento do perfil excede WLAN_MAX_NAME_LENGTH.
  • O membro wlanConnectionMode da estrutura apontada por pConnectionParameters é definido como wlan_connection_mode_profile e o membro strProfile da mesma estrutura é NULL ou o comprimento do perfil é zero.
  • O membro wlanConnectionMode da estrutura apontada por pConnectionParameters é definido como wlan_connection_mode_invalid ou wlan_connection_mode_auto.
  • O membro dot11BssType da estrutura apontada por pConnectionParameters é definido como dot11_BSS_type_infrastructure e o membro dwFlags da mesma estrutura é definido como WLAN_CONNECTION_ADHOC_JOIN_ONLY.
  • O membro dot11BssType da estrutura apontada por pConnectionParameters é definido como dot11_BSS_type_independent e o membro dwFlags da mesma estrutura é definido como WLAN_CONNECTION_HIDDEN_NETWORK.
  • O membro dwFlags da estrutura apontada por pConnectionParameters é definido como WLAN_CONNECTION_IGNORE_PRIVACY_BIT e o membro wlanConnectionMode da mesma estrutura não está definido como wlan_connection_mode_temporary_profile ou o membro do dot11BssType da mesma estrutura é definido como dot11_BSS_type_independent.
ERROR_INVALID_HANDLE
 O identificador hClientHandle não foi encontrado na tabela de identificador.
RPC_STATUS
 Vários códigos de erro.
ERROR_ACCESS_DENIED
 O chamador não tem permissões suficientes.

Comentários

A função WlanConnect retorna imediatamente. Para ser notificado quando uma conexão é estabelecida ou quando nenhuma conexão adicional será tentada, um cliente deve se registrar para notificações chamando WlanRegisterNotification.

O membro strProfile da estrutura de WLAN_CONNECTION_PARAMETERS apontada por pConnectionParameters especifica o perfil a ser usado para conexão. Se esse perfil for um perfil de todos os usuários, o chamador WlanConnect deverá ter acesso de execução no perfil. Caso contrário, a chamada WlanConnect falhará com o valor retornado ERROR_ACCESS_DENIED. As permissões em um perfil de todos os usuários são estabelecidas quando o perfil é criado ou salvo usando WlanSetProfile ou WlanSaveTemporaryProfile.

Para executar uma operação de conexão na linha de comando, use o comando netsh wlan connect . Para obter mais informações, consulte Comandos netsh para rede local sem fio (wlan).

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Você só pode usar o WlanConnect para se conectar a redes na lista de rede preferencial. Para adicionar uma rede à lista de rede preferencial, chame WlanSetProfile.

Requisitos

   
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]
Plataforma de Destino Windows
Cabeçalho wlanapi.h (inclua Wlanapi.h)
Biblioteca Wlanapi.lib
DLL Wlanapi.dll
Redistribuível API de LAN sem fio para Windows XP com SP2

Confira também

WLAN_CONNECTION_PARAMETERS

WlanDisconnect