Partager via


énumération WLAN_HOSTED_NETWORK_REASON (wlanapi.h)

Le type énuméré WLAN_HOSTED_NETWORK_REASON spécifie les valeurs possibles pour le résultat d’un appel de fonction réseau hébergé sans fil.

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
Valeur : 0
L'opération a réussi.
wlan_hosted_network_reason_unspecified
Erreur inconnue.
wlan_hosted_network_reason_bad_parameters
Paramètres incorrects.

Par exemple, le code est retourné si une application n’a pas pu référencer le contexte client à partir du handle approprié (le handle retourné par la fonction WlanOpenHandle ).
wlan_hosted_network_reason_service_shutting_down
Le service s’arrête.
wlan_hosted_network_reason_insufficient_resources
Le service n’a plus de ressources.
wlan_hosted_network_reason_elevation_required
Cette opération nécessite une élévation.
wlan_hosted_network_reason_read_only
Une tentative d’écriture de données en lecture seule a été effectuée.
wlan_hosted_network_reason_persistence_failed
Échec de la persistance des données.
wlan_hosted_network_reason_crypt_error
Une erreur de chiffrement s’est produite.
wlan_hosted_network_reason_impersonation
Échec de l’emprunt d’identité de l’utilisateur.
wlan_hosted_network_reason_stop_before_start
Une séquence d’appels de fonction incorrecte a été effectuée.
wlan_hosted_network_reason_interface_available
Une interface sans fil est désormais disponible.
wlan_hosted_network_reason_interface_unavailable
Une interface sans fil est devenue indisponible.

C’est la raison pour laquelle le code est retourné par le réseau hébergé sans fil qui fonctionne chaque fois que l’état du réseau hébergé sans fil est wlan_hosted_network_unavailable. Par exemple, si le réseau hébergé sans fil est désactivé par la stratégie de groupe sur un domaine, l’état du réseau hébergé sans fil est wlan_hosted_network_unavailable. Dans ce cas, tout appel à la fonction WlanHostedNetworkStartUsing ou WlanHostedNetworkForceStart renvoie ce code de raison.
wlan_hosted_network_reason_miniport_stopped
Le pilote de miniport sans fil a arrêté le réseau hébergé.
wlan_hosted_network_reason_miniport_started
Le pilote miniport sans fil status changé.
wlan_hosted_network_reason_incompatible_connection_started
Une connexion incompatible a démarré.

Une connexion incompatible fait référence à l’un des cas suivants :

  • Une connexion sans fil ad hoc est démarrée sur l’adaptateur de la station principale.

  • La surveillance réseau est démarrée sur la carte de la station principale par une application (Moniteur réseau, par exemple) qui appelle la fonction WlanSetInterface avec le paramètre OpCode défini sur wlan_intf_opcode_current_operation_mode et le paramètre pData pointe vers un ULONG qui contient DOT11_OPERATION_MODE_NETWORK_MONITOR.

  • Une connexion sans fil est démarrée en mode sans échec FIPS sur l’adaptateur de la station principale. Le mode sans échec FIPS est spécifié dans le profil de la connexion sans fil. Pour plus d’informations, consultez l’élément FIPSMode.




Windows arrête le réseau hébergé sans fil sur l’adaptateur de point d’accès sans fil (AP) basé sur le logiciel lorsqu’une connexion incompatible démarre sur l’adaptateur de la station principale. L’état du réseau hébergé sans fil devient wlan_hosted_network_unavailable.
wlan_hosted_network_reason_incompatible_connection_stopped
Une connexion incompatible s’est arrêtée.

Une connexion incompatible a démarré précédemment sur l’adaptateur de la station principale (wlan_hosted_network_reason_incompatible_connection_started), mais la connexion incompatible s’est arrêtée. Si le réseau hébergé sans fil a été précédemment arrêté suite au démarrage d’une connexion incompatible, Windows ne redémarre pas automatiquement le réseau hébergé sans fil. Les applications peuvent redémarrer le réseau hébergé sans fil sur la carte AP en appelant la fonction WlanHostedNetworkStartUsing ou WlanHostedNetworkForceStart .
wlan_hosted_network_reason_user_action
Un changement d’état s’est produit en raison d’une action explicite de l’utilisateur.
wlan_hosted_network_reason_client_abort
Un changement d’état s’est produit en raison de l’abandon du client.
wlan_hosted_network_reason_ap_start_failed
Le pilote du réseau hébergé sans fil n’a pas pu démarrer.
wlan_hosted_network_reason_peer_arrived
Un homologue connecté au réseau hébergé sans fil.
wlan_hosted_network_reason_peer_departed
Un homologue déconnecté du réseau hébergé sans fil.
wlan_hosted_network_reason_peer_timeout
Un homologue a expiré.
wlan_hosted_network_reason_gp_denied
L’opération a été refusée par la stratégie de groupe.
wlan_hosted_network_reason_service_unavailable
Le service LAN sans fil n’est pas en cours d’exécution.
wlan_hosted_network_reason_device_change
La carte sans fil utilisée par le réseau hébergé sans fil a changé.
wlan_hosted_network_reason_properties_change
Les propriétés du réseau hébergé sans fil ont changé.
wlan_hosted_network_reason_virtual_station_blocking_use
Une station virtuelle est une opération active et bloquante.
wlan_hosted_network_reason_service_available_on_virtual_station
Un service identique est disponible sur une station virtuelle.

Remarques

Le WLAN_HOSTED_NETWORK_REASON type énuméré est une extension aux API sans fil natives ajoutées pour prendre en charge le réseau hébergé sans fil sur Windows 7 et versions ultérieures.

Le WLAN_HOSTED_NETWORK_REASON énumère les raisons possibles pour lesquelles un appel de fonction réseau hébergé sans fil a échoué ou les raisons pour lesquelles une notification de réseau hébergé sans fil particulière a été générée.

Sur Windows 7 et versions ultérieures, le système d’exploitation installe un appareil virtuel si une carte sans fil compatible réseau hébergé est présente sur l’ordinateur. Cet appareil virtuel s’affiche normalement dans le dossier Connexions réseau sous la forme « Connexion réseau sans fil 2 » avec le nom de l’appareil « Carte miniport Microsoft Virtual WiFi » si l’ordinateur dispose d’une seule carte réseau sans fil. Cet appareil virtuel est utilisé exclusivement pour effectuer des connexions de point d’accès logiciel (SoftAP) et n’est pas présent dans la liste retournée par la fonction WlanEnumInterfaces . La durée de vie de cet appareil virtuel est liée à l’adaptateur sans fil physique. Si l’adaptateur sans fil physique est désactivé, cet appareil virtuel est également supprimé.

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête wlanapi.h (incluez Wlanapi.h)

Voir aussi

WlanEnumInterfaces

WlanHostedNetworkForceStart

WlanHostedNetworkForceStop

WlanHostedNetworkInitSettings

WlanHostedNetworkQuerySecondaryKey

WlanHostedNetworkRefreshSecuritySettings

WlanHostedNetworkSetProperty

WlanHostedNetworkSetSecondaryKey

WlanHostedNetworkStartUsing

WlanHostedNetworkStopUsing