Função WlanHostedNetworkStartUsing (wlanapi.h)
A função WlanHostedNetworkStartUsing inicia a rede hospedada sem fio.
Sintaxe
DWORD WlanHostedNetworkStartUsing(
[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 WlanHostedNetworkStartUsing 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.
Código de retorno | Descrição |
---|---|
|
Um parâmetro está incorreto. Esse erro será retornado se alguma das seguintes condições ocorrer:
|
|
Um identificador é inválido. Esse erro será retornado se o identificador especificado no parâmetro hClientHandle não tiver sido encontrado na tabela de identificador. |
|
O recurso não está no estado correto para executar a operação solicitada. Esse erro será retornado se a rede hospedada sem fio estiver desabilitada pela política de grupo em um domínio. |
|
O serviço não foi iniciado. Esse erro será retornado se o Serviço de Configuração Automática WLAN não estiver em execução. |
|
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 WlanHostedNetworkStartUsing é 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 WlanHostedNetworkStartUsing para iniciar a rede hospedada sem fio. Chamadas bem-sucedidas devem ser correspondidas por chamadas para a função WlanHostedNetworkStopUsing . Essa chamada poderá falhar se o estado da Rede Hospedada for wlan_hosted_network_unavailable.
Qualquer alteração de estado da Rede Hospedada causada por essa funçã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.
Qualquer usuário pode chamar a função WlanHostedNetworkStartUsing para iniciar 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 posteriores, 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 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 sem fio físico 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 de 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 |
Confira também
Sobre a rede hospedada sem fio
Usando rede hospedada sem fio e compartilhamento de conexão com a Internet