Fonction WlanHostedNetworkRefreshSecuritySettings (wlanapi.h)

Article
08/28/2023

La fonction WlanHostedNetworkRefreshSecuritySettings actualise les parties configurables et générées automatiquement des paramètres de sécurité du réseau hébergé sans fil.

Syntaxe

DWORD WlanHostedNetworkRefreshSecuritySettings(
  [in]            HANDLE                      hClientHandle,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Paramètres

[in] hClientHandle

Le handle de session du client, retourné par un appel précédent à la fonction WlanOpenHandle .

[out, optional] pFailReason

Pointeur facultatif vers une valeur qui reçoit la raison de l’échec, si l’appel à la fonction WlanHostedNetworkRefreshSecuritySettings échoue. Les valeurs possibles pour la raison de l’échec proviennent du type d’énumération WLAN_HOSTED_NETWORK_REASON défini dans le fichier d’en-tête Wlanapi.h .

pvReserved

Réservé pour un usage futur. Ce paramètre doit avoir la valeur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour peut être l’un des codes de retour suivants.

Code de retour	Description
ERROR_INVALID_HANDLE	Un handle n’est pas valide. Cette erreur est retournée si le handle spécifié dans le paramètre hClientHandle n’a pas été trouvé dans la table handle.
ERROR_INVALID_PARAMETER	Un paramètre est incorrect. Cette erreur est retournée si l’une des conditions suivantes se produit : hClientHandle a lavaleur NULL. pvReserved n’a pas la valeur NULL.
ERROR_INVALID_STATE	La ressource n’est pas dans l’état correct pour effectuer l’opération demandée.
ERROR_SERVICE_NOT_ACTIVE	Le service n'a pas été démarré. Cette erreur est retournée si le service de configuration automatique WLAN n’est pas en cours d’exécution.
Autres	Divers codes d’erreur RPC et autres. Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée.

Remarques

La fonction WlanHostedNetworkRefreshSecuritySettings est une extension des API sans fil natives ajoutées pour prendre en charge le réseau hébergé sans fil sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé.

Une application cliente appelle la fonction WlanHostedNetworkRefreshSecuritySettings pour forcer l’actualisation des parties configurables et générées automatiquement des paramètres de sécurité (la clé primaire) sur le réseau hébergé sans fil.

Une application peut appeler la fonction WlanHostedNetworkRefreshSecuritySettings après avoir vérifié que l’utilisateur accepte l’impact de la mise à jour des paramètres de sécurité. Pour réussir, cette fonction doit conserver les nouveaux paramètres, ce qui exigerait que l’état du réseau hébergé soit transféré vers wlan_hosted_network_idle s’il était en cours d’exécution (wlan_hosted_network_active).

Note Tous les clients réseau (PC ou appareils) sur le réseau hébergé sans fil doivent être reconfigurés après l’appel de la fonction WlanHostedNetworkRefreshSecuritySettings si leur utilisation continue est un objectif. Une application appelle généralement cette fonction dans les situations où l’utilisateur estime que la sécurité de la clé primaire précédente utilisée pour la sécurité par le réseau hébergé sans fil a été violée. Notez que la fonction WlanHostedNetworkRefreshSecuritySettings ne modifie ni ne réinitialise la clé secondaire.

Tout changement d’état du réseau hébergé provoqué par cette fonction ne serait pas automatiquement annulé si l’application appelante ferme son handle d’appel (en appelant WlanCloseHandle avec le paramètre hClientHandle ) ou si le processus se termine.

Tout utilisateur peut appeler la fonction WlanHostedNetworkRefreshSecuritySettings pour actualiser les paramètres de sécurité sur le réseau hébergé. Toutefois, la possibilité d’activer le réseau hébergé sans fil peut être limitée par la stratégie de groupe dans un domaine.

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 « Network Connections » sous la forme « Connexion réseau sans fil 2 » avec le nom de l’appareil « Microsoft Virtual WiFi Miniport adapter » 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 sera également supprimé. Cette fonctionnalité est également disponible sur Windows Server 2008 R2 avec le service LAN sans fil installé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wlanapi.h (inclure Wlanapi.h)
Bibliothèque	Wlanapi.lib
DLL	Wlanapi.dll