énumération WLAN_HOSTED_NETWORK_REASON (wlanapi.h)

Article
08/28/2023

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)