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.

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

Voir aussi

WlanOpenHandle