Função WlanDisconnect (wlanapi.h)
A função WlanDisconnect desconecta uma interface de sua rede atual.
Sintaxe
DWORD WlanDisconnect(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
PVOID pReserved
);
Parâmetros
[in] hClientHandle
O identificador de sessão do cliente, obtido por uma chamada anterior para a função WlanOpenHandle .
[in] pInterfaceGuid
O GUID da interface a ser desconectada.
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 |
|---|---|
|
hClientHandle é NULL ou inválido, pInterfaceGuid é NULL ou pReserved não é NULL. |
|
O identificador hClientHandle não foi encontrado na tabela de identificadores. |
|
Vários códigos de erro. |
|
Falha ao alocar memória para os resultados da consulta. |
|
O chamador não tem permissões suficientes. |
Comentários
Quando a conexão foi estabelecida usando WlanConnect, um perfil foi especificado pelo membro strProfile da estrutura WLAN_CONNECTION_PARAMETERS apontada por pConnectionParameters. Se esse perfil fosse um perfil de todos os usuários, o chamador WlanDisconnect deverá ter acesso de execução no perfil. Caso contrário, a chamada WlanDisconnect 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 desconexão na linha de comando, use o comando netsh wlan disconnect . 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: WlanDisconnect tem o efeito colateral de modificar o perfil associado à rede desconectada. Um perfil de rede se torna um perfil sob demanda após uma chamada WlanDisconnect . O serviço de Configuração Sem Fio Zero não se conectará automaticamente a uma rede com um perfil sob demanda quando a rede estiver no intervalo. Não chame WlanDisconnect antes de chamar WlanConnect , a menos que você queira alterar um perfil para um perfil sob demanda. Quando você chama WlanConnect para estabelecer uma conexão de rede, qualquer conexão de rede existente é descartada automaticamente.
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 |