Função WlanHostedNetworkQueryStatus (wlanapi.h)

Artigo
03/04/2024

A função WlanHostedNetworkQueryStatus consulta o status atual da rede hospedada sem fio.

Sintaxe

DWORD WlanHostedNetworkQueryStatus(
  [in]  HANDLE                      hClientHandle,
  [out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
        PVOID                       pvReserved
);

Parâmetros

[in] hClientHandle

O identificador de sessão do cliente, retornado por uma chamada anterior para a função WlanOpenHandle .

[out] ppWlanHostedNetworkStatus

Na entrada, esse parâmetro deve ser NULL.

Na saída, esse parâmetro receberá um ponteiro para o status atual da Rede Hospedada sem fio, se a chamada para a função WlanHostedNetworkQueryStatus for bem-sucedida. O status atual é retornado em uma estrutura WLAN_HOSTED_NETWORK_STATUS.

pvReserved

Reservado para uso futuro. Esse parâmetro deve ser NULL.

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	Um identificador é inválido. Esse erro será retornado se o identificador especificado no parâmetro hClientHandle não tiver sido encontrado na tabela de identificadores.
ERROR_INVALID_PARAMETER	Um parâmetro está incorreto. Esse erro será retornado se qualquer uma das seguintes condições ocorrer: hClientHandle é NULL. ppWlanHostedNetworkStatus é NULL. pvReserved não é NULL.
ERROR_INVALID_STATE	O recurso não está no estado correto para executar a operação solicitada. Isso pode ocorrer se a Rede Hospedada sem fio estiver em processo de desligamento.
ERROR_SERVICE_NOT_ACTIVE	O serviço não foi iniciado. Esse erro será retornado se o Serviço de Configuração Automática da WLAN não estiver em execução.
Outros	Vários RPC e outros códigos de erro. Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

A função WlanHostedNetworkQueryStatus é uma extensão para APIs sem fio nativas adicionadas para dar suporte à Rede Hospedada sem fio no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado.

Um aplicativo cliente chama a função WlanHostedNetworkQueryStatus para consultar a status atual da Rede Hospedada sem fio. Essa função não altera o estado da Rede Hospedada sem fio.

Se a função for bem-sucedida, o parâmetro ppWlanHostedNetworkStatus apontará para uma estrutura WLAN_HOSTED_NETWORK_STATUS com o status atual. A memória usada para a estrutura de WLAN_HOSTED_NETWORK_STATUS retornada deve ser liberada após o uso chamando a função WlanFreeMemory .

Qualquer usuário pode chamar a função WlanHostedNetworkQueryStatus para consultar a Rede Hospedada. No entanto, a capacidade de habilitar a Rede Hospedada sem fio pode ser restrita pela política de grupo em um domínio.

No Windows 7 e posterior, o sistema operacional instalará um dispositivo virtual se um adaptador sem fio compatível com a Rede Hospedada estiver presente no computador. Esse dispositivo virtual normalmente aparece na "Pasta de Connections de Rede" como "Conexão de Rede Sem Fio 2" com um Nome de Dispositivo de "Adaptador de Miniporto WiFi Virtual da Microsoft" se o computador tiver um único adaptador de rede sem fio. Esse dispositivo virtual é usado exclusivamente para executar conexões de ponto de acesso de software (SoftAP) e não está presente na lista retornada pela função WlanEnumInterfaces . O tempo de vida desse dispositivo virtual está vinculado ao adaptador sem fio físico. Se o adaptador físico sem fio estiver desabilitado, esse dispositivo virtual também será removido. Esse recurso também está disponível no Windows Server 2008 R2 com o Serviço lan sem fio instalado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wlanapi.h (inclua Wlanapi.h)
Biblioteca	Wlanapi.lib
DLL	Wlanapi.dll