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 |
|---|---|
|
hClientHandle a la valeur NULL ou non valide, ou pReserved n’a pas la valeur NULL. |
|
Le handle hClientHandle est introuvable dans la table handle. |
|
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 |