Função WlanCloseHandle (wlanapi.h)
A função WlanCloseHandle fecha uma conexão com o servidor.
Sintaxe
DWORD WlanCloseHandle(
[in] HANDLE hClientHandle,
PVOID pReserved
);
Parâmetros
[in] hClientHandle
O identificador de sessão do cliente, que identifica a conexão a ser fechada. Esse identificador foi obtido por uma chamada anterior para a função WlanOpenHandle .
pReserved
Reservado para uso futuro. Defina esse parâmetro 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 ou pReserved não é NULL. |
|
O identificador hClientHandle não foi encontrado na tabela de identificadores. |
|
Vários códigos de erro. |
Comentários
Depois que uma conexão for fechada, qualquer tentativa de uso do identificador fechado poderá causar erros inesperados. Ao fechar, todas as notificações pendentes são descartadas.
Não chame WlanCloseHandle de uma função de retorno de chamada. Se o cliente estiver no meio de um retorno de chamada de notificação quando WlanCloseHandle for chamado, a função aguardará a conclusão do retorno de chamada antes de retornar um valor. Chamar essa função dentro de uma função de retorno de chamada fará com que a chamada nunca seja concluída. Se a função de retorno de chamada e o thread que fecha o identificador tentarem adquirir o mesmo bloqueio, poderá ocorrer um deadlock. Além disso, não chame WlanCloseHandle da função DllMain em uma DLL de aplicativo. Isso também pode causar um deadlock.
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 |