Função WFDStartOpenSession (wlanapi.h)

Artigo
08/28/2023

A função WFDStartOpenSession inicia uma conexão sob demanda com um dispositivo Wi-Fi Direct específico, que foi emparelhado anteriormente por meio da experiência emparelhamento do Windows.

Sintaxe

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

Parâmetros

[in] hClientHandle

Um identificador de cliente para o serviço Wi-Fi Direct. Esse identificador foi obtido por uma chamada anterior para a função WFDOpenHandle .

[in] pDeviceAddress

Um ponteiro para o endereço do dispositivo Wi-Fi Direct do dispositivo de destino. Esse é o endereço MAC do dispositivo de Wi-Fi de destino.

[in, optional] pvContext

Um ponteiro de contexto opcional que é passado para a função de retorno de chamada especificada no parâmetro pfnCallback .

[in] pfnCallback

Um ponteiro para a função de retorno de chamada a ser chamada depois que a solicitação WFDStartOpenSession for concluída.

[out] phSessionHandle

Um identificador para essa sessão específica Wi-Fi Direct.

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 hClientHandle não tiver sido encontrado na tabela de identificadores.
ERROR_INVALID_PARAMETER	O parâmetro está incorreto. Esse erro será retornado se o parâmetro hClientHandle for NULL ou não for válido. Esse erro também será retornado se o parâmetro pDeviceAddress for NULL, o parâmetro pfnCallback for NULL ou o parâmetro phSessionHandle for NULL. Esse valor também será retornado se o parâmetro dwClientVersion não for igual a WFD_API_VERSION.
ERROR_INVALID_STATE	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.
ERROR_SERVICE_NOT_ACTIVE	O serviço não foi iniciado. Esse erro será retornado se o Serviço de Configuração Automática da WLAN não estiver em execução.
RPC_STATUS	Vários códigos de erro.

Comentários

A função WFDStartOpenSession 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 WFDStartOpenSession inicia uma operação assíncrona para iniciar uma conexão sob demanda com um dispositivo Wi-Fi Direct específico. O Wi-Fi dispositivo de destino deve ter sido emparelhado anteriormente por meio da experiência emparelhamento do Windows. Quando a operação assíncrona é concluída, a função de retorno de chamada especificada no parâmetro pfnCallback é chamada.

Se o aplicativo tentar fechar o identificador do serviço Wi-Fi Direct chamando a função WFDCloseHandle antes que a função WFDStartOpenSession seja concluída de forma assíncrona, a função WFDCloseHandle aguardará até que a chamada WFDStartOpenSession seja concluída.

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