enumeración WLAN_HOSTED_NETWORK_REASON (wlanapi.h)

Artículo
03/08/2023

El tipo enumerado WLAN_HOSTED_NETWORK_REASON especifica los valores posibles para el resultado de una llamada de función de red hospedada inalámbrica.

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 La operación se realizó correctamente.
`wlan_hosted_network_reason_unspecified` Error desconocido.
`wlan_hosted_network_reason_bad_parameters` Parámetros incorrectos. Por ejemplo, este código de motivo se devuelve si una aplicación no pudo hacer referencia al contexto de cliente desde el identificador correcto (el identificador devuelto por la función WlanOpenHandle ).
`wlan_hosted_network_reason_service_shutting_down` El servicio se está cerrando.
`wlan_hosted_network_reason_insufficient_resources` El servicio está fuera de recursos.
`wlan_hosted_network_reason_elevation_required` Esta operación requiere elevación.
`wlan_hosted_network_reason_read_only` Se intentó escribir datos de solo lectura.
`wlan_hosted_network_reason_persistence_failed` Error de persistencia de datos.
`wlan_hosted_network_reason_crypt_error` Error criptográfico.
`wlan_hosted_network_reason_impersonation` Error de suplantación de usuario.
`wlan_hosted_network_reason_stop_before_start` Se realizó una secuencia de llamada de función incorrecta.
`wlan_hosted_network_reason_interface_available` Hay disponible una interfaz inalámbrica.
`wlan_hosted_network_reason_interface_unavailable` Una interfaz inalámbrica no está disponible. Este código de motivo lo devuelven las funciones inalámbricas de red hospedada en cualquier momento en que el estado de red inalámbrica de la red hospedada inalámbrica es wlan_hosted_network_unavailable. Por ejemplo, si la red hospedada inalámbrica está deshabilitada por la directiva de grupo en un dominio, el estado de red de la red hospedada inalámbrica se wlan_hosted_network_unavailable. En este caso, cualquier llamada a la función WlanHostedNetworkStartUsing o WlanHostedNetworkForceStart devolvería este código de motivo.
`wlan_hosted_network_reason_miniport_stopped` El controlador de minipuerto inalámbrico detuvo la red hospedada.
`wlan_hosted_network_reason_miniport_started` El estado del controlador de minipuerto inalámbrico ha cambiado.
`wlan_hosted_network_reason_incompatible_connection_started` Se inició una conexión incompatible. Una conexión incompatible hace referencia a uno de los siguientes casos: Se inicia una conexión inalámbrica ad hoc en el adaptador de estación principal. La supervisión de red se inicia en el adaptador de estación principal mediante una aplicación (Monitor de red, por ejemplo) que llama a la función WlanSetInterface con el parámetro OpCode establecido en wlan_intf_opcode_current_operation_mode y el parámetro pData apunta a un ULONG que contiene DOT11_OPERATION_MODE_NETWORK_MONITOR. Se inicia una conexión inalámbrica en modo seguro FIPS en el adaptador de estación principal. El modo seguro FIPS se especifica en el perfil de la conexión inalámbrica. Para obtener más información, vea el elemento FIPSMode. Windows detendrá la red hospedada inalámbrica en el adaptador de punto de acceso inalámbrico (AP) basado en software cuando se inicie una conexión incompatible en el adaptador de estación principal. El estado de red del estado de red hospedada inalámbrica se convertiría en wlan_hosted_network_unavailable.
`wlan_hosted_network_reason_incompatible_connection_stopped` Se ha detenido una conexión incompatible. Una conexión incompatible iniciada anteriormente en el adaptador de estación principal (wlan_hosted_network_reason_incompatible_connection_started), pero la conexión incompatible se ha detenido. Si la red hospedada inalámbrica se detuvo anteriormente como resultado de que se inicia una conexión incompatible, Windows no reiniciará automáticamente la red hospedada inalámbrica. Las aplicaciones pueden reiniciar la red hospedada inalámbrica en el adaptador de AP llamando a la función WlanHostedNetworkStartUsing o WlanHostedNetworkForceStart .
`wlan_hosted_network_reason_user_action` Se produjo un cambio de estado causado por una acción explícita del usuario.
`wlan_hosted_network_reason_client_abort` Se produjo un cambio de estado causado por la anulación del cliente.
`wlan_hosted_network_reason_ap_start_failed` No se pudo iniciar el controlador de la red hospedada inalámbrica.
`wlan_hosted_network_reason_peer_arrived` Un par conectado a la red hospedada inalámbrica.
`wlan_hosted_network_reason_peer_departed` Un par desconectado de la red hospedada inalámbrica.
`wlan_hosted_network_reason_peer_timeout` Se agota el tiempo de espera del mismo nivel.
`wlan_hosted_network_reason_gp_denied` La directiva de grupo denegó la operación.
`wlan_hosted_network_reason_service_unavailable` El servicio LAN inalámbrico no se está ejecutando.
`wlan_hosted_network_reason_device_change` El adaptador inalámbrico utilizado por la red hospedada inalámbrica cambió.
`wlan_hosted_network_reason_properties_change` Las propiedades de la red hospedada inalámbrica cambiaron.
`wlan_hosted_network_reason_virtual_station_blocking_use` Una estación virtual está activa y bloqueando la operación.
`wlan_hosted_network_reason_service_available_on_virtual_station` Hay un servicio idéntico disponible en una estación virtual.

Comentarios

El tipo enumerado WLAN_HOSTED_NETWORK_REASON es una extensión a las API inalámbricas nativas agregadas para admitir la red inalámbrica hospedada en Windows 7 y versiones posteriores.

El WLAN_HOSTED_NETWORK_REASON enumera los posibles motivos por los que se produjo un error en una llamada de función de red hospedada inalámbrica o por los motivos por los que se generó una notificación de red hospedada inalámbrica determinada.

En Windows 7 y versiones posteriores, el sistema operativo instala un dispositivo virtual si un adaptador inalámbrico compatible con red hospedada está presente en la máquina. Este dispositivo virtual aparece normalmente en la "Carpeta conexiones de red" como "Conexión de red inalámbrica 2" con un nombre de dispositivo de "Adaptador de miniporte de WiFi virtual de Microsoft" si el equipo tiene un único adaptador de red inalámbrica. Este dispositivo virtual se usa exclusivamente para realizar conexiones de punto de acceso de software (SoftAP) y no está presente en la lista devuelta por la función WlanEnumInterfaces . La duración de este dispositivo virtual está vinculada al adaptador inalámbrico físico. Si el adaptador inalámbrico físico está deshabilitado, este dispositivo virtual también se quitará.

Requisitos


Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	wlanapi.h (incluya Wlanapi.h)