Função WFDCloseHandle (wlanapi.h)

Artigo
08/28/2023

A função WFDCloseHandle fecha um identificador para o serviço Wi-Fi Direct.

Sintaxe

DWORD WFDCloseHandle(
  [in] HANDLE hClientHandle
);

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 .

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 identificador.
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.
RPC_STATUS	Vários códigos de erro.

Comentários

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

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 WFD (Wi-Fi Direct) 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 os recursos usados pelo aplicativo.

Requisitos


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