Compartilhar via

Função WlanCloseHandle (wlanapi.h)

  • Artigo

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
ERROR_INVALID_PARAMETER
 hClientHandle é NULL ou inválido ou pReserved não é NULL.
ERROR_INVALID_HANDLE
 O identificador hClientHandle não foi encontrado na tabela de identificadores.
RPC_STATUS
 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

Confira também

WlanOpenHandle