Partager via

Fonction WlanOpenHandle (wlanapi.h)

  • Article

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