Função WFDOpenLegacySession (wlanapi.h)
A função WFDOpenLegacySession recupera e aplica um perfil armazenado para um dispositivo herdado Wi-Fi Direct.
Sintaxe
DWORD WFDOpenLegacySession(
HANDLE hClientHandle,
PDOT11_MAC_ADDRESS pLegacyMacAddress,
HANDLE *phSessionHandle,
GUID *pGuidSessionInterface
);
Parâmetros
hClientHandle
Um HANDLE para o serviço Wi-Fi Direct para esta sessão. Esse parâmetro é recuperado usando a função WFDOpenHandle .
pLegacyMacAddress
Um ponteiro para Wi-Fi endereço de dispositivo Direto do dispositivo cliente herdado.
phSessionHandle
Um ponteiro para um HANDLE para receber o identificador para o serviço Wi-Fi Direct para esta sessão.
Se a função WFDOpenLegacySession for bem-sucedida, um identificador para o serviço Wi-Fi Direct a ser usado nesta sessão será retornado.
pGuidSessionInterface
Um ponteiro para o GUID do adaptador de rede para esta sessão.
Se a função WFDOpenLegacySession for bem-sucedida, um GUID do adaptador de rede no qual Wi-Fi sessão Direta será retornada.
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 phClientHandle ou o parâmetro pLegacyMacAddress for NULL. |
|
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. |
|
Vários códigos de erro. |
Comentários
A função WFDOpenLegacySession 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 WFDOpenLegacySession ou WFDOpenHandle . O identificador do WFD (Wi-Fi Direct) retornado pela função WFDOpenHandle é usado para chamadas subsequentes feitas ao serviço Wi-Fi Direct. A função WFDOpenLegacySession é usada para recuperar e aplicar um perfil armazenado para um dispositivo herdado Wi-Fi Direct.
A função WFDOpenLegacySession recupera o perfil herdado armazenado para o dispositivo do repositório de perfil para o endereço do dispositivo herdado especificado. Esse endereço do dispositivo deve ser obtido de um Nó de Dispositivo criado como resultado da experiência de emparelhamento da Caixa de Entrada (Emparelhamento WPS Herdado).
Depois que um aplicativo é feito usando o serviço Wi-Fi Direct, o aplicativo deve chamar a função WFDCloseSession para fechar a sessão e 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
| 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 |