Fonction WlanConnect (wlanapi.h)
La fonction WlanConnect tente de se connecter à un réseau spécifique.
DWORD WlanConnect(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] const PWLAN_CONNECTION_PARAMETERS pConnectionParameters,
PVOID pReserved
);
[in] hClientHandle
Handle de session du client, retourné par un appel précédent à la fonction WlanOpenHandle .
[in] pInterfaceGuid
GUID de l’interface à utiliser pour la connexion.
[in] pConnectionParameters
Pointeur vers une structure WLAN_CONNECTION_PARAMETERS qui spécifie le type de connexion, le mode, le profil réseau, le SSID qui identifie le réseau et d’autres paramètres.
Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Il existe des contraintes sur les membres WLAN_CONNECTION_PARAMETERS . Cela signifie que les structures valides pour Windows Server 2008 et Windows Vista peuvent ne pas être valides pour Windows XP avec SP3 ou l’API LAN sans fil pour Windows XP avec SP2. Pour obtenir la liste des contraintes, consultez WLAN_CONNECTION_PARAMETERS.
pReserved
Réservé pour un usage futur. Doit être défini sur NULL.
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 |
---|---|
|
L’une des conditions suivantes s’est produite :
|
|
Le handle hClientHandle est introuvable dans la table de handles. |
|
Différents codes d’erreur. |
|
L’appelant ne dispose pas des autorisations suffisantes. |
La fonction WlanConnect retourne immédiatement. Pour être averti lorsqu’une connexion est établie ou qu’aucune autre connexion ne sera tentée, un client doit s’inscrire aux notifications en appelant WlanRegisterNotification.
Le membre strProfile de la structure WLAN_CONNECTION_PARAMETERS pointée par pConnectionParameters spécifie le profil à utiliser pour la connexion. Si ce profil est un profil pour tous les utilisateurs, l’appelant WlanConnect doit disposer d’un accès d’exécution sur le profil. Sinon, l’appel WlanConnect échoue avec la valeur de retour ERROR_ACCESS_DENIED. Les autorisations sur un profil tous les utilisateurs sont établies lorsque le profil est créé ou enregistré à l’aide de WlanSetProfile ou de WlanSaveTemporaryProfile.
Pour effectuer une opération de connexion sur la ligne de commande, utilisez la commande netsh wlan connect . Pour plus d’informations, consultez Commandes Netsh pour le réseau local sans fil (wlan).
Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Vous pouvez uniquement utiliser WlanConnect pour vous connecter aux réseaux figurant dans la liste des réseaux préférés. Pour ajouter un réseau à la liste des réseaux préférés, appelez WlanSetProfile.
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] |
Plateforme cible | Windows |
En-tête | wlanapi.h (incluez Wlanapi.h) |
Bibliothèque | Wlanapi.lib |
DLL | Wlanapi.dll |
Composant redistribuable | API LAN sans fil pour Windows XP avec SP2 |