Partager via

Fonction WlanConnect (wlanapi.h)

  • Article

La fonction WlanConnect tente de se connecter à un réseau spécifique.

Syntaxe

DWORD WlanConnect(
  [in] HANDLE                            hClientHandle,
  [in] const GUID                        *pInterfaceGuid,
  [in] const PWLAN_CONNECTION_PARAMETERS pConnectionParameters,
       PVOID                             pReserved
);

Paramètres

[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.

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_PARAMETER
 L’une des conditions suivantes s’est produite :
  • hClientHandle est NULL ou non valide.
  • pInterfaceGuid a la valeur NULL.
  • pConnectionParameters a la valeur NULL.
  • Le membre dwFlags de la structure pointée par pConnectionParameters n’est pas défini sur l’une des valeurs spécifiées dans la page WLAN_CONNECTION_PARAMETERS .
  • Le membre wlanConnectionMode de la structure pointée par pConnectionParameters est défini sur wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure, et le membre pDot11Ssid de la même structure est NULL.
  • Le membre wlanConnectionMode de la structure pointée par pConnectionParameters est défini sur wlan_connection_mode_discovery_secure ou wlan_connection_mode_discovery_unsecure, et le membre dot11BssType de la même structure est défini sur dot11_BSS_type_any.
  • Le membre wlanConnectionMode de la structure pointée par pConnectionParameters est défini sur wlan_connection_mode_profile, et le membre strProfile de la même structure est NULL ou la longueur du profil dépasse WLAN_MAX_NAME_LENGTH.
  • Le membre wlanConnectionMode de la structure pointée par pConnectionParameters est défini sur wlan_connection_mode_profile, et le membre strProfile de la même structure est NULL ou la longueur du profil est égale à zéro.
  • Le membre wlanConnectionMode de la structure pointée par pConnectionParameters est défini sur wlan_connection_mode_invalid ou wlan_connection_mode_auto.
  • Le membre dot11BssType de la structure pointée par pConnectionParameters est défini sur dot11_BSS_type_infrastructure, et le membre dwFlags de la même structure est défini sur WLAN_CONNECTION_ADHOC_JOIN_ONLY.
  • Le membre dot11BssType de la structure pointée par pConnectionParameters est défini sur dot11_BSS_type_independent, et le membre dwFlags de la même structure est défini sur WLAN_CONNECTION_HIDDEN_NETWORK.
  • Le membre dwFlags de la structure pointée par pConnectionParameters est défini sur WLAN_CONNECTION_IGNORE_PRIVACY_BIT et le membre wlanConnectionMode de la même structure n’est pas défini sur wlan_connection_mode_temporary_profile ou le membre dot11BssType de la même structure est défini sur dot11_BSS_type_independent.
ERROR_INVALID_HANDLE
 Le handle hClientHandle est introuvable dans la table de handles.
RPC_STATUS
 Différents codes d’erreur.
ERROR_ACCESS_DENIED
 L’appelant ne dispose pas des autorisations suffisantes.

Remarques

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.

Spécifications

   
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

Voir aussi

WLAN_CONNECTION_PARAMETERS

WlanDisconnect