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.

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

Confira também

WlanOpenHandle