Função WFDOpenHandle (wlanapi.h)

Artigo
12/22/2023

A função WFDOpenHandle abre um identificador para o serviço Wi-Fi Direct e negocia uma versão da API Direta de Wi-FI a ser usada.

Sintaxe

DWORD WFDOpenHandle(
  [in]  DWORD   dwClientVersion,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Parâmetros

[in] dwClientVersion

A versão mais alta do Wi-Fi API Direta à qual o cliente dá suporte.

Para Windows 8 e Windows Server 2012, esse parâmetro deve ser definido como WFD_API_VERSION, constante definida no arquivo de cabeçalho Wlanapi.h.

[out] pdwNegotiatedVersion

Um ponteiro para um DWORD para receber a versão negociada.

Se a função WFDOpenHandle for bem-sucedida, a versão negociada com o Wi-Fi Serviço Direto a ser usado por esta sessão será retornada. Esse valor geralmente é a versão mais alta compatível com o cliente e Wi-Fi serviço Direto.

[out] phClientHandle

Um ponteiro para um HANDLE para receber o identificador para o serviço Wi-Fi Direct para esta sessão.

Se a função WFDOpenHandle for bem-sucedida, um identificador para o serviço Wi-Fi Direct a ser usado nesta sessão será retornado.

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_PARAMETER	O parâmetro está incorreto. Esse erro será retornado se o parâmetro pdwNegotiatedVersion for NULL ou o parâmetro phClientHandle for NULL. Esse valor também será retornado se o parâmetro dwClientVersion não for igual a WFD_API_VERSION.
ERROR_NOT_ENOUGH_MEMORY	Não há armazenamento suficiente disponível para processar esse comando. Esse erro será retornado se o sistema não puder alocar memória para criar o contexto do cliente.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	Houve uma tentativa de estabelecer uma sessão para um servidor de rede, mas já há muitas sessões estabelecidas para esse servidor. Esse erro será retornado se muitos identificadores tiverem sido emitidos pelo serviço Wi-Fi Direct.
RPC_STATUS	Vários códigos de erro.

Comentários

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

Para usar Wi-Fi Direct, um aplicativo deve primeiro obter um identificador para o serviço Wi-Fi Direct chamando a função WFDOpenHandle . O identificador do Wi-Fi Direct (WFD) retornado pela função WFDOpenHandle é usado para chamadas subsequentes feitas ao serviço Wi-Fi Direct. Depois que um aplicativo é feito usando o serviço Wi-Fi Direct, o aplicativo deve chamar a função WFDCloseHandle para sinalizar ao serviço Wi-Fi Direct que o aplicativo é feito usando o serviço. Isso permite que o serviço Wi-Fi Direct libere recursos usados pelo aplicativo.

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