enumeração WLAN_HOSTED_NETWORK_REASON (wlanapi.h)

Artigo
08/28/2023

O WLAN_HOSTED_NETWORK_REASON tipo enumerado especifica os valores possíveis para o resultado de uma chamada de função rede hospedada sem fio.

Syntax

typedef enum _WLAN_HOSTED_NETWORK_REASON {
  wlan_hosted_network_reason_success = 0,
  wlan_hosted_network_reason_unspecified,
  wlan_hosted_network_reason_bad_parameters,
  wlan_hosted_network_reason_service_shutting_down,
  wlan_hosted_network_reason_insufficient_resources,
  wlan_hosted_network_reason_elevation_required,
  wlan_hosted_network_reason_read_only,
  wlan_hosted_network_reason_persistence_failed,
  wlan_hosted_network_reason_crypt_error,
  wlan_hosted_network_reason_impersonation,
  wlan_hosted_network_reason_stop_before_start,
  wlan_hosted_network_reason_interface_available,
  wlan_hosted_network_reason_interface_unavailable,
  wlan_hosted_network_reason_miniport_stopped,
  wlan_hosted_network_reason_miniport_started,
  wlan_hosted_network_reason_incompatible_connection_started,
  wlan_hosted_network_reason_incompatible_connection_stopped,
  wlan_hosted_network_reason_user_action,
  wlan_hosted_network_reason_client_abort,
  wlan_hosted_network_reason_ap_start_failed,
  wlan_hosted_network_reason_peer_arrived,
  wlan_hosted_network_reason_peer_departed,
  wlan_hosted_network_reason_peer_timeout,
  wlan_hosted_network_reason_gp_denied,
  wlan_hosted_network_reason_service_unavailable,
  wlan_hosted_network_reason_device_change,
  wlan_hosted_network_reason_properties_change,
  wlan_hosted_network_reason_virtual_station_blocking_use,
  wlan_hosted_network_reason_service_available_on_virtual_station
} WLAN_HOSTED_NETWORK_REASON, *PWLAN_HOSTED_NETWORK_REASON;

Constantes


`wlan_hosted_network_reason_success` Valor: 0 A operação foi bem-sucedida.
`wlan_hosted_network_reason_unspecified` Erro desconhecido.
`wlan_hosted_network_reason_bad_parameters` Parâmetros inválidos. Por exemplo, esse código de motivo será retornado se um aplicativo não fizer referência ao contexto do cliente do identificador correto (o identificador retornado pela função WlanOpenHandle ).
`wlan_hosted_network_reason_service_shutting_down` O serviço está sendo desligado.
`wlan_hosted_network_reason_insufficient_resources` O serviço está sem recursos.
`wlan_hosted_network_reason_elevation_required` Essa operação requer elevação.
`wlan_hosted_network_reason_read_only` Foi feita uma tentativa de gravar dados somente leitura.
`wlan_hosted_network_reason_persistence_failed` Falha na persistência de dados.
`wlan_hosted_network_reason_crypt_error` Ocorreu um erro criptográfico.
`wlan_hosted_network_reason_impersonation` Falha na representação do usuário.
`wlan_hosted_network_reason_stop_before_start` Uma sequência de chamada de função incorreta foi feita.
`wlan_hosted_network_reason_interface_available` Uma interface sem fio ficou disponível.
`wlan_hosted_network_reason_interface_unavailable` Uma interface sem fio ficou indisponível. Esse código de motivo é retornado pelas funções de Rede Hospedada sem fio sempre que o estado de rede da Rede Hospedada sem fio é wlan_hosted_network_unavailable. Por exemplo, se a rede hospedada sem fio estiver desabilitada pela política de grupo em um domínio, o estado de rede da Rede Hospedada sem fio será wlan_hosted_network_unavailable. Nesse caso, todas as chamadas para a função WlanHostedNetworkStartUsing ou WlanHostedNetworkForceStart retornariam esse código de motivo.
`wlan_hosted_network_reason_miniport_stopped` O driver de miniporta sem fio parou a Rede Hospedada.
`wlan_hosted_network_reason_miniport_started` O driver de miniporta sem fio status alterado.
`wlan_hosted_network_reason_incompatible_connection_started` Uma conexão incompatível iniciada. Uma conexão incompatível refere-se a um dos seguintes casos: Uma conexão sem fio ad hoc é iniciada no adaptador de estação principal. O monitoramento de rede é iniciado no adaptador de estação primária por um aplicativo (Monitor de Rede, por exemplo) que chama a função WlanSetInterface com o parâmetro OpCode definido como wlan_intf_opcode_current_operation_mode e o parâmetro pData aponta para um ULONG que contém DOT11_OPERATION_MODE_NETWORK_MONITOR. Uma conexão sem fio é iniciada no modo de segurança FIPS no adaptador de estação principal. O modo de segurança FIPS é especificado no perfil da conexão sem fio. Para obter mais informações, consulte o elemento FIPSMode. O Windows interromperá a Rede Hospedada sem fio no adaptador ap (ponto de acesso sem fio) baseado em software quando uma conexão incompatível for iniciada no adaptador de estação primária. O estado da rede do estado da Rede Hospedada sem fio se tornaria wlan_hosted_network_unavailable.
`wlan_hosted_network_reason_incompatible_connection_stopped` Uma conexão incompatível foi interrompida. Uma conexão incompatível iniciada anteriormente no adaptador de estação primária (wlan_hosted_network_reason_incompatible_connection_started), mas a conexão incompatível foi interrompida. Se a rede hospedada sem fio tiver sido interrompida anteriormente como resultado da inicialização de uma conexão incompatível, o Windows não reiniciará automaticamente a Rede Hospedada sem fio. Os aplicativos podem reiniciar a rede hospedada sem fio no adaptador AP chamando a função WlanHostedNetworkStartUsing ou WlanHostedNetworkForceStart .
`wlan_hosted_network_reason_user_action` Ocorreu uma alteração de estado causada por uma ação explícita do usuário.
`wlan_hosted_network_reason_client_abort` Ocorreu uma alteração de estado causada pela anulação do cliente.
`wlan_hosted_network_reason_ap_start_failed` O driver da Rede Hospedada sem fio não foi iniciado.
`wlan_hosted_network_reason_peer_arrived` Um par conectado à Rede Hospedada sem fio.
`wlan_hosted_network_reason_peer_departed` Um par desconectado da Rede Hospedada sem fio.
`wlan_hosted_network_reason_peer_timeout` Um par atingiu o tempo limite.
`wlan_hosted_network_reason_gp_denied` A operação foi negada pela política de grupo.
`wlan_hosted_network_reason_service_unavailable` O serviço lan sem fio não está em execução.
`wlan_hosted_network_reason_device_change` O adaptador sem fio usado pela Rede Hospedada sem fio foi alterado.
`wlan_hosted_network_reason_properties_change` As propriedades da Rede Hospedada sem fio foram alteradas.
`wlan_hosted_network_reason_virtual_station_blocking_use` Uma estação virtual está ativa e bloqueando a operação.
`wlan_hosted_network_reason_service_available_on_virtual_station` Um serviço idêntico está disponível em uma estação virtual.

Comentários

O WLAN_HOSTED_NETWORK_REASON tipo enumerado é uma extensão para APIs sem fio nativas adicionadas para dar suporte à Rede Hospedada sem fio no Windows 7 e posterior.

O WLAN_HOSTED_NETWORK_REASON enumera os possíveis motivos pelos quais uma chamada de função de rede hospedada sem fio falhou ou os motivos pelos quais uma notificação de rede hospedada sem fio específica foi gerada.

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 Conexões 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.

Requisitos


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]
Cabeçalho	wlanapi.h (inclua Wlanapi.h)