função de retorno de chamada WFD_OPEN_SESSION_COMPLETE_CALLBACK (wlanapi.h)

Artigo
12/22/2023

A função WFD_OPEN_SESSION_COMPLETE_CALLBACK define a função de retorno de chamada que é chamada pela função WFDStartOpenSession quando a operação WFDStartOpenSession é concluída.

Sintaxe

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

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 .

[in] pvContext

Um ponteiro de contexto passado para a função de retorno de chamada da função WFDStartOpenSession .

[in] guidSessionInterface

O GUID da interface do adaptador de rede local no qual esse dispositivo Wi-Fi Direct tem uma sessão aberta. Esse parâmetro será útil se os protocolos de camada superior precisarem determinar a qual interface de rede uma sessão Wi-Fi Direct está associada. Esse valor só será retornado se o parâmetro dwError for ERROR_SUCCESS.

[in] dwError

Um valor que especifica se houve um erro encontrado durante a chamada para a função WFDStartOpenSession . Se esse valor for ERROR_SUCCESS, nenhum erro ocorreu e a operação para abrir a sessão foi concluída com êxito.

Os outros valores a seguir são possíveis:

Valor	Significado
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.
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 WLAN não estiver em execução.
RPC_STATUS	Vários RPC e outros códigos de erro. Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

[in] dwReasonCode

Um valor que especifica mais detalhes se ocorreu um erro durante WFDStartOpenSession.

Retornar valor

Nenhum

Comentários

A função WFD_OPEN_SESSION_COMPLETE_CALLBACK 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).

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 dispositivo de Wi-Fi de destino deve ter sido emparelhado anteriormente por meio da experiência de Emparelhamento do Windows. Quando a operação assíncrona para fazer a conexão Wi-FI Direct for concluída, a função de retorno de chamada especificada no parâmetro pfnCallback será chamada.

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