structure WLAN_CONNECTION_PARAMETERS (wlanapi.h)
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 |