Função WFDCancelOpenSession (wlanapi.h)

Artigo
08/28/2023

A função WFDCancelOpenSession indica que o aplicativo deseja cancelar uma função pendente do WFDStartOpenSession que não foi concluída.

Sintaxe

DWORD WFDCancelOpenSession(
  [in] HANDLE hSessionHandle
);

Parâmetros

[in] hSessionHandle

Um identificador de sessão para uma sessão Wi-Fi Direct a ser cancelada. 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
ERROR_INVALID_HANDLE	O manipulador é inválido. Esse erro será retornado se o identificador especificado no parâmetro hSessionHandle não tiver sido encontrado na tabela de identificador.
ERROR_INVALID_PARAMETER	O parâmetro está incorreto. Esse erro será retornado se o parâmetro hSessionHandle for NULL ou não for válido.
RPC_STATUS	Vários códigos de erro.

Comentários

A função WFDCancelOpenSession faz parte do Wi-Fi Direct, um novo recurso em Windows 8 e Windows Server 2012. Wi-Fi Direct baseia-se no desenvolvimento da especificação técnica ponto a ponto Wi-Fi v1.1 pela Wi-Fi Alliance (consulte Especificações publicadas da Aliança Wi-Fi). A meta 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 adjunto de Wi-Fi existente (IBSS).

Uma chamada para a função WFDCancelOpenSession notifica o serviço Wi-Fi Direct de que o cliente solicita um cancelamento desta sessão. A função WFDCancelOpenSession não modifica o comportamento esperado de WFDStartOpenSession . A função de retorno de chamada especificada para a função WFDStartOpenSession ainda será chamada e a função WFDStartOpenSession pode não ser concluída imediatamente.

É responsabilidade do chamador passar a função WFDCancelOpenSession um identificador no parâmetro hSessionHandle que foi retornado da chamada para a função WFDStartOpenSession .

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