Fonction WlanCloseHandle (wlanapi.h)

La fonction WlanCloseHandle ferme une connexion au serveur.

Syntaxe

DWORD WlanCloseHandle(
  [in] HANDLE hClientHandle,
       PVOID  pReserved
);

Paramètres

[in] hClientHandle

Le handle de session du client, qui identifie la connexion à fermer. Ce handle a été obtenu par un appel précédent à la fonction WlanOpenHandle .

pReserved

Réservé pour un usage futur. Définissez ce paramètre 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, ou pReserved n’a pas la valeur NULL.
ERROR_INVALID_HANDLE
Le handle hClientHandle est introuvable dans la table handle.
RPC_STATUS
Différents codes d’erreur.

Remarques

Une fois la connexion fermée, toute tentative d’utilisation du handle fermé peut provoquer des erreurs inattendues. À la fermeture, toutes les notifications en attente sont ignorées.

N’appelez pas WlanCloseHandle à partir d’une fonction de rappel. Si le client se trouve au milieu d’un rappel de notification lorsque WlanCloseHandle est appelé, la fonction attend que le rappel se termine avant de retourner une valeur. L’appel de cette fonction à l’intérieur d’une fonction de rappel entraîne la fin de l’appel. Si la fonction de rappel et le thread qui ferme le handle tentent d’acquérir le même verrou, un blocage peut se produire. En outre, n’appelez pas WlanCloseHandle à partir de la fonction DllMain dans une DLL d’application. Cela peut également provoquer un blocage.

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

WlanOpenHandle