Condividi tramite


enumerazione WLAN_HOSTED_NETWORK_REASON (wlanapi.h)

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)

Vedi anche

WlanEnumInterfaces

WlanHostedNetworkForceStart

WlanHostedNetworkForceStop

WlanHostedNetworkInitSettings

WlanHostedNetworkQuerySecondaryKey

WlanHostedNetworkRefreshSecuritySettings

WlanHostedNetworkSetProperty

WlanHostedNetworkSetSecondaryKey

WlanHostedNetworkStartUsing

WlanHostedNetworkStopUsing