Fonction WlanDisconnect (wlanapi.h)

Article
08/28/2023

La fonction WlanDisconnect déconnecte une interface de son réseau actuel.

Syntaxe

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

Paramètres

[in] hClientHandle

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

[in] pInterfaceGuid

GUID de l’interface à déconnecter.

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	hClientHandle a la valeur NULL ou non valide, pInterfaceGuid a la valeur NULL ou pReserved n’est pas NULL.
ERROR_INVALID_HANDLE	Le handle hClientHandle est introuvable dans la table handle.
RPC_STATUS	Différents codes d’erreur.
ERROR_NOT_ENOUGH_MEMORY	Échec de l’allocation de mémoire pour les résultats de la requête.
ERROR_ACCESS_DENIED	L’appelant n’a pas les autorisations suffisantes.

Remarques

Lorsque la connexion a été établie à l’aide de WlanConnect, un profil a été spécifié par le membre strProfile de la structure WLAN_CONNECTION_PARAMETERS pointée vers pConnectionParameters. Si ce profil était un profil tout utilisateur, l’appelant WlanDisconnect doit disposer d’un accès d’exécution sur le profil. Sinon, l’appel WlanDisconnect échoue avec la valeur de retour ERROR_ACCESS_DENIED. Les autorisations sur un profil tout utilisateur sont établies lorsque le profil est créé ou enregistré à l’aide de WlanSetProfile ou de WlanSaveTemporaryProfile.

Pour effectuer une opération de déconnexion sur la ligne de commande, utilisez la commande netsh wlan disconnect . Pour plus d’informations, consultez Netsh Commands for Wireless Local Area Network (wlan).

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : WlanDisconnect a pour effet secondaire de modifier le profil associé au réseau déconnecté. Un profil réseau devient un profil à la demande après un appel WlanDisconnect . Le service Configuration zéro sans fil ne se connecte pas automatiquement à un réseau avec un profil à la demande lorsque le réseau est à portée. N’appelez pas WlanDisconnect avant d’appeler WlanConnect , sauf si vous souhaitez remplacer un profil par un profil à la demande. Lorsque vous appelez WlanConnect pour établir une connexion réseau, toute connexion réseau existante est automatiquement supprimée.

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 (inclure Wlanapi.h)
Bibliothèque	Wlanapi.lib
DLL	Wlanapi.dll
Composant redistribuable	API LAN sans fil pour Windows XP avec SP2

Voir aussi

WlanConnect

Partager via