Função WlanHostedNetworkForceStop (wlanapi.h)

A função WlanHostedNetworkForceStop faz a transição da Rede Hospedada sem fio para o wlan_hosted_network_idle sem associar a solicitação ao identificador de chamada do aplicativo.

Sintaxe

DWORD WlanHostedNetworkForceStop(
  [in]            HANDLE                      hClientHandle,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Parâmetros

[in] hClientHandle

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

[out, optional] pFailReason

Um ponteiro opcional para um valor que recebe o motivo da falha, se a chamada para a função WlanHostedNetworkForceStop falhar. Os valores possíveis para o motivo da falha são do tipo de enumeração WLAN_HOSTED_NETWORK_REASON definido no arquivo de cabeçalho Wlanapi.h .

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.

Comentários

A função WlanHostedNetworkForceStop é 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 lan sem fio instalado.

Um aplicativo cliente chama a função WlanHostedNetworkForceStop para forçar a interrupção da Rede Hospedada e fazer a transição da Rede Hospedada sem fio para o wlan_hosted_network_idle sem associar a solicitação ao identificador de chamada do aplicativo. Um cliente normalmente chama a função WlanHostedNetworkForceStop para corresponder a uma chamada bem-sucedida anterior à função WlanHostedNetworkForceStart .

A função WlanHostedNetworkForceStop poderá falhar se o estado da Rede Hospedada não for wlan_hosted_network_active.

Qualquer alteração de estado de Rede Hospedada causada por essa função não será desfeita automaticamente se o aplicativo de chamada fechar seu identificador de chamada (chamando WlanCloseHandle com o parâmetro hClientHandle ) ou se o processo terminar.

Um aplicativo pode chamar a função WlanHostedNetworkForceStop para interromper a Rede Hospedada após uma chamada anterior ao WlanHostedNetworkForceStart por um usuário do sistema com privilégios elevados que aceitou os requisitos de energia maiores envolvidos na execução da Rede Hospedada sem fio por longos períodos.

Qualquer usuário pode chamar a função WlanHostedNetworkForceStop para forçar a parada da 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

Confira também

Sobre a rede hospedada sem fio

Usando a rede hospedada sem fio e o compartilhamento de conexão com a Internet

WLAN_HOSTED_NETWORK_REASON

WLAN_SECURABLE_OBJECT

WlanCloseHandle

WlanEnumInterfaces

WlanHostedNetworkForceStart

WlanHostedNetworkQueryStatus

WlanHostedNetworkStartUsing

WlanHostedNetworkStopUsing

WlanOpenHandle