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