Fonction WlanOpenHandle (wlanapi.h)

Article
08/28/2023

La fonction WlanOpenHandle ouvre une connexion au serveur.

Syntaxe

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Paramètres

[in] dwClientVersion

Version la plus élevée de l’API WLAN prise en charge par le client.

Valeur	Signification
1	Version cliente pour Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2.
2	Version du client pour Windows Vista et Windows Server 2008

pReserved

Réservé pour un usage futur. Doit être défini sur NULL.

[out] pdwNegotiatedVersion

Version de l’API WLAN qui sera utilisée dans cette session. Cette valeur est généralement la version la plus élevée prise en charge à la fois par le client et le serveur.

[out] phClientHandle

Handle que le client doit utiliser dans cette session. Ce handle est utilisé par d’autres fonctions tout au long de la session.

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	pdwNegotiatedVersion a la valeur NULL, phClientHandle a la valeur NULL ou pReserved n’est pas NULL.
ERROR_NOT_ENOUGH_MEMORY	Échec de l’allocation de mémoire pour créer le contexte client.
RPC_STATUS	Différents codes d’erreur.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	Trop de handles ont été émis par le serveur.

Remarques

Le numéro de version spécifié par dwClientVersion et pdwNegotiatedVersion est un numéro de version composite composé des versions principales et mineures. La version principale est spécifiée par le mot de bas ordre, et la version mineure est spécifiée par le mot d’ordre élevé. Les macros WLAN_API_VERSION_MAJOR(_v) et WLAN_API_VERSION_MINOR(_v) retournent respectivement les numéros de version principale et secondaire. Vous pouvez construire un numéro de version à l’aide de la macro WLAN_API_MAKE_VERSION(_major, _minor).

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : WlanOpenHandle retourne un message d’erreur si le service WZC (Wireless Zero Configuration) n’a pas été démarré ou si le service WZC n’est pas réactif.

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

WlanCloseHandle

Partager via