Função WFDStartOpenSession (wlanapi.h)
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |