Função WFDCloseSession (wlanapi.h)
A função WFDCloseSession fecha uma sessão após uma chamada anteriormente bem-sucedida para a função WFDStartOpenSession .
Sintaxe
DWORD WFDCloseSession(
[in] HANDLE hSessionHandle
);
Parâmetros
[in] hSessionHandle
Um identificador de sessão para uma sessão Wi-Fi Direct. Esse é um identificador de sessão retornado anteriormente pela função WFDStartOpenSession .
Retornar valor
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 |
|---|---|
|
O manipulador é inválido.
Esse erro será retornado se o identificador especificado no parâmetro hSessionHandle não for encontrado na tabela handle. |
|
O parâmetro está incorreto.
Esse erro será retornado se o parâmetro hSessionHandle for NULL ou não for válido. |
|
O grupo ou recurso não está no estado correto para executar a operação solicitada.
Esse erro será retornado se o serviço Wi-Fi Direct estiver desabilitado pela política de grupo em um domínio. |
|
Vários códigos de erro. |
Comentários
A função WFDCloseSession faz parte do Wi-Fi Direct, um novo recurso em Windows 8 e Windows Server 2012. Wi-Fi Direct baseia-se no desenvolvimento do Wi-Fi Especificação Técnica Ponto a Ponto v1.1 pela Wi-Fi Alliance (consulte Especificações publicadas da Aliança Wi-Fi). O objetivo do Wi-Fi Especificação Técnica Ponto a Ponto é fornecer uma solução para Wi-Fi conectividade dispositivo a dispositivo sem a necessidade de um PONTO de Acesso Sem Fio (AP sem fio) para configurar a conexão ou o uso do mecanismo de ad hoc de Wi-Fi existente (IBSS).
A função WFDCloseSession enfileira um item de trabalho futuro para fechar a sessão, portanto, a desconexão pode não ser imediata.
Chamar a função WFDCloseSession enquanto uma chamada WFDStartOpenSession estiver pendente não fechará a sessão.
É responsabilidade do chamador passar a função WFDCloseSession um identificador no parâmetro hSessionHandle que foi retornado de uma chamada assíncrona bem-sucedida para a função WFDStartOpenSession .
Chamar a função WFDCloseSession com um identificador que era válido e se tornou inválido produzirá resultados indefinidos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wlanapi.h |
| Biblioteca | Wlanapi.lib |
| DLL | Wlanapi.dll |