enumerazione WLAN_HOSTED_NETWORK_REASON (wlanapi.h)

Articolo
08/28/2023

Il tipo enumerato WLAN_HOSTED_NETWORK_REASON specifica i valori possibili per il risultato di una chiamata di funzione di rete ospitata wireless.

Sintassi

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;

Costanti


`wlan_hosted_network_reason_success` Valore: 0 L'operazione è stata completata.
`wlan_hosted_network_reason_unspecified` Errore sconosciuto.
`wlan_hosted_network_reason_bad_parameters` Parametri non valido. Ad esempio, questo codice motivo viene restituito se un'applicazione non è riuscita a fare riferimento al contesto client dall'handle corretto (l'handle restituito dalla funzione WlanOpenHandle ).
`wlan_hosted_network_reason_service_shutting_down` Il servizio viene arrestato.
`wlan_hosted_network_reason_insufficient_resources` Il servizio non è disponibile.
`wlan_hosted_network_reason_elevation_required` Questa operazione richiede l'elevazione.
`wlan_hosted_network_reason_read_only` È stato eseguito un tentativo di scrittura di dati di sola lettura.
`wlan_hosted_network_reason_persistence_failed` La persistenza dei dati non è riuscita.
`wlan_hosted_network_reason_crypt_error` Si è verificato un errore crittografico.
`wlan_hosted_network_reason_impersonation` La rappresentazione dell'utente non è riuscita.
`wlan_hosted_network_reason_stop_before_start` È stata eseguita una sequenza di chiamate di funzione non corretta.
`wlan_hosted_network_reason_interface_available` Un'interfaccia wireless è diventata disponibile.
`wlan_hosted_network_reason_interface_unavailable` Un'interfaccia wireless non è disponibile. Questo motivo il codice viene restituito dalle funzioni di rete ospitata wireless ogni volta che lo stato di rete della rete ospitata wireless è wlan_hosted_network_unavailable. Ad esempio, se la rete ospitata wireless è disabilitata dai criteri di gruppo in un dominio, lo stato di rete della rete ospitata wireless è wlan_hosted_network_unavailable. In questo caso, le chiamate alla funzione WlanHostedNetworkStartUsing o WlanHostedNetworkForceStart restituirebbero questo codice motivo.
`wlan_hosted_network_reason_miniport_stopped` Il driver miniport wireless ha arrestato la rete ospitata.
`wlan_hosted_network_reason_miniport_started` Lo stato del driver del miniport wireless è cambiato.
`wlan_hosted_network_reason_incompatible_connection_started` Una connessione incompatibile avviata. Una connessione incompatibile fa riferimento a uno dei casi seguenti: Viene avviata una connessione wireless ad hoc sulla scheda della stazione primaria. Il monitoraggio della rete viene avviato nella scheda della stazione primaria da un'applicazione (Monitoraggio rete, ad esempio) che chiama la funzione WlanSetInterface con il parametro OpCode impostato su wlan_intf_opcode_current_operation_mode e il parametro pData punta a un oggetto ULONG contenente DOT11_OPERATION_MODE_NETWORK_MONITOR. Viene avviata una connessione wireless in modalità sicura FIPS nella scheda della stazione primaria. La modalità sicura FIPS viene specificata nel profilo della connessione wireless. Per altre informazioni, vedere l'elemento FIPSMode. Windows arresterà la rete ospitata wireless nella scheda del punto di accesso wireless (AP) basata sul software quando viene avviata una connessione non compatibile sulla scheda della stazione primaria. Lo stato di rete dello stato della rete ospitata wireless diventa wlan_hosted_network_unavailable.
`wlan_hosted_network_reason_incompatible_connection_stopped` È stata arrestata una connessione incompatibile. Una connessione incompatibile avviata in precedenza sulla scheda della stazione primaria (wlan_hosted_network_reason_incompatible_connection_started), ma la connessione incompatibile è stata arrestata. Se la rete ospitata wireless è stata arrestata in precedenza in seguito all'avvio di una connessione non compatibile, Windows non riavvia automaticamente la rete ospitata wireless. Le applicazioni possono riavviare la rete ospitata wireless nella scheda API chiamando la funzione WlanHostedNetworkStartUsing o WlanHostedNetworkForceStart.
`wlan_hosted_network_reason_user_action` Si è verificata una modifica dello stato che è stata causata dall'azione esplicita dell'utente.
`wlan_hosted_network_reason_client_abort` Si è verificato un cambiamento di stato causato dall'interruzione del client.
`wlan_hosted_network_reason_ap_start_failed` Impossibile avviare il driver per la rete ospitata wireless.
`wlan_hosted_network_reason_peer_arrived` Peer connesso alla rete ospitata wireless.
`wlan_hosted_network_reason_peer_departed` Peer disconnesso dalla rete ospitata wireless.
`wlan_hosted_network_reason_peer_timeout` Timeout peer.
`wlan_hosted_network_reason_gp_denied` L'operazione è stata negata dai criteri di gruppo.
`wlan_hosted_network_reason_service_unavailable` Il servizio LAN wireless non è in esecuzione.
`wlan_hosted_network_reason_device_change` La scheda wireless usata dalla rete ospitata wireless è stata modificata.
`wlan_hosted_network_reason_properties_change` Le proprietà della rete ospitata wireless sono state modificate.
`wlan_hosted_network_reason_virtual_station_blocking_use` Una stazione virtuale è attiva e blocca l'operazione.
`wlan_hosted_network_reason_service_available_on_virtual_station` Un servizio identico è disponibile in una stazione virtuale.

Commenti

Il tipo enumerato WLAN_HOSTED_NETWORK_REASON è un'estensione alle API wireless native aggiunte per supportare la rete ospitata wireless in Windows 7 e versioni successive.

La WLAN_HOSTED_NETWORK_REASON enumera i possibili motivi per cui è stata generata una chiamata di funzione di rete ospitata wireless o i motivi per cui è stata generata una determinata notifica di rete ospitata wireless.

In Windows 7 e versioni successive il sistema operativo installa un dispositivo virtuale se una scheda wireless con supporto per la rete ospitata è presente nel computer. Questo dispositivo virtuale viene normalmente visualizzato nella "cartella Connessioni di rete" come "Connessione di rete wireless 2" con un nome dispositivo di "Scheda Miniport WiFi virtuale Microsoft" se il computer ha una singola scheda di rete wireless. Questo dispositivo virtuale viene usato esclusivamente per eseguire connessioni softAP (Software Access Point) e non è presente nell'elenco restituito dalla funzione WlanEnumInterfaces . La durata di questo dispositivo virtuale è associata alla scheda wireless fisica. Se l'adattatore wireless fisico è disabilitato, questo dispositivo virtuale verrà rimosso anche.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	wlanapi.h (include Wlanapi.h)