structure WLAN_CONNECTION_PARAMETERS (wlanapi.h)

Article
12/22/2023

La structure WLAN_CONNECTION_PARAMETERS spécifie les paramètres utilisés lors de l’utilisation de la fonction WlanConnect .

Syntaxe

typedef struct _WLAN_CONNECTION_PARAMETERS {
  WLAN_CONNECTION_MODE wlanConnectionMode;
#if ...
  LPCWSTR              strProfile;
#else
  LPCWSTR              strProfile;
#endif
  PDOT11_SSID          pDot11Ssid;
  PDOT11_BSSID_LIST    pDesiredBssidList;
  DOT11_BSS_TYPE       dot11BssType;
  DWORD                dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;

Membres

wlanConnectionMode

Valeur WLAN_CONNECTION_MODE qui spécifie le mode de connexion.

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Seule la valeur wlan_connection_mode_profile est prise en charge.

strProfile

Spécifie le profil utilisé pour la connexion.

Si wlanConnectionMode a la valeur wlan_connection_mode_profile, strProfile spécifie le nom du profil utilisé pour la connexion. Si wlanConnectionMode est défini sur wlan_connection_mode_temporary_profile, strProfile spécifie la représentation XML du profil utilisé pour la connexion. Si wlanConnectionMode est défini sur wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure, strProfile doit avoir la valeur NULL.

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Le profil doit répondre aux critères de compatibilité décrits dans Compatibilité du profil sans fil.

pDot11Ssid

Pointeur vers une structure DOT11_SSID qui spécifie le SSID du réseau auquel se connecter. Ce paramètre est facultatif. Lorsqu’il est défini sur NULL, tous les SSID du profil sont essayés. Ce paramètre ne doit pas avoir la valeur NULL si WLAN_CONNECTION_MODE a la valeur wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure.

pDesiredBssidList

Pointeur vers une structure de DOT11_BSSID_LIST qui contient la liste des identificateurs de jeu de services de base (BSS) souhaités pour la connexion.

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Ce membre doit être NULL.

dot11BssType

Valeur DOT11_BSS_TYPE qui indique le type BSS du réseau. Si un profil est fourni, ce type BSS doit être identique à celui du profil.

dwFlags

Le tableau suivant présente les indicateurs utilisés pour spécifier les paramètres de connexion.

Constant	Valeur	Description
WLAN_CONNECTION_HIDDEN_NETWORK	0x00000001	Connectez-vous au réseau de destination même si la destination est un réseau masqué. Un réseau masqué ne diffuse pas son SSID. N’utilisez pas cet indicateur si le réseau de destination est un réseau ad hoc. Si le profil spécifié par strProfile n’est pas NULL, cet indicateur est ignoré et l’élément de profil nonBroadcast détermine s’il faut se connecter à un réseau masqué.
WLAN_CONNECTION_ADHOC_JOIN_ONLY	0x00000002	Ne formez pas de réseau ad hoc. Rejoignez un réseau ad hoc uniquement si le réseau existe déjà. N’utilisez pas cet indicateur si le réseau de destination est un réseau d’infrastructure.
WLAN_CONNECTION_IGNORE_PRIVACY_BIT	0x00000004	Ignorez le bit de confidentialité lors de la connexion au réseau. Ignorer le bit de confidentialité a pour effet d’ignorer si les paquets sont chiffrés et d’ignorer la méthode de chiffrement utilisée. Utilisez cet indicateur uniquement lors de la connexion à un réseau d’infrastructure à l’aide d’un profil temporaire.
WLAN_CONNECTION_EAPOL_PASSTHROUGH	0x00000008	Exemptez le trafic EAPOL du chiffrement et du déchiffrement. Cet indicateur est utilisé lorsqu’une application doit envoyer le trafic EAPOL sur un réseau d’infrastructure qui utilise l’authentification ouverte et le chiffrement WEP. Cet indicateur ne doit pas être utilisé pour se connecter à des réseaux qui nécessitent une authentification 802.1X. Cet indicateur n’est valide que lorsque wlanConnectionMode est défini sur wlan_connection_mode_temporary_profile. Évitez d’utiliser cet indicateur dans la mesure du possible.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE	0x00000010	Conserver automatiquement le profil de découverte en cas de réussite de la connexion. Cet indicateur n’est valide que pour wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure. Le profil est enregistré en tant que profil utilisateur complet, avec le nom généré à partir du SSID à l’aide de WlanUtf8SsidToDisplayName. S’il existe déjà un profil portant le même nom, un numéro est ajouté à la fin du nom du profil. Le profil est enregistré en mode de connexion manuelle, sauf si WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO est également spécifié.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO	0x00000020	À utiliser conjointement avec WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. Le profil de découverte est conservé avec le mode de connexion automatique.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING	0x00000040	À utiliser conjointement avec WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE. Le profil de découverte est conservé et tente de remplacer un profil existant portant le même nom.

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Ce membre doit être défini sur 0.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	wlanapi.h
Composant redistribuable	API LAN sans fil pour Windows XP avec SP2

Voir aussi

WlanConnect

Share via