Função WFDCloseHandle (wlanapi.h)

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

Confira também

WFDCancelOpenSession

WFDCloseSession

WFDOpenHandle

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK