Découverte de l'API Microsoft Native Wifi [Tutoriel]

**ram-0000** · 20/12/2009, 23h45

Découverte de l'API Microsoft Native Wifi

Ce document a pour but de présenter l'API Microsoft Native Wifi de gestion des réseaux Wifi dans l'environnement Microsoft Windows. Il présente aussi un exemple écrit en C utilisant cette API permettant d'énumérer les réseaux Wifi disponibles.

A vos commentaires

!

**therealmancool** · 26/05/2010, 21h22

Gros merci pour ton boulot qui m'a beaucoup aider.

Mais je voulais savoir si tu avais réussi a utiliser cette API pour te connecter à un réseau?

J'ai des problèmes concernant l'utilisation de la fonction wlanconnect que j'explique ici.

**ram-0000** · 26/05/2010, 21h33

Envoyé par therealmancool

Gros merci pour ton boulot qui m'a beaucoup aider.

Merci et content que cela ait pu t'aider.

Envoyé par therealmancool

Mais je voulais savoir si tu avais réussi a utiliser cette API pour te connecter à un réseau?

J'ai des problèmes concernant l'utilisation de la fonction wlanconnect que j'explique ici.

Je ne suis pas allé plus loin que ce qui est expliqué dans le tutoriel, désolé

**nicolas.sitbon** · 30/09/2010, 12h59

Je me suis permis (encore une fois

) de retranscrire le code C++ en code C (et de modifier 2 ou 3 trucs cosmétiques). Je te laisse voir si tu veux intégrer ces modifications.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
#include <stdio.h>
#include <tchar.h>
#include <locale.h>
#include <windows.h>
#include <wlanapi.h>
#include <objbase.h>
 
#ifdef _MSC_VER
# pragma comment(lib, "Wlanapi.lib")
# pragma comment(lib, "ole32.lib")
#endif
 
static void DisplayError(LPCTSTR message, DWORD lastError)
{
   LPTSTR buffer = NULL;
   if(message == NULL){message = _T("Error");}
 
   if(FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_ALLOCATE_BUFFER, NULL, lastError, 0, (LPTSTR)&buffer, 0, NULL) == 0)
   {
      if(GetLastError() == ERROR_NOT_ENOUGH_MEMORY)
      {
         _ftprintf(stderr, _T("%s : not enough memory\n"), message);
      }
      else
      {
         _ftprintf(stderr, _T("FormatMessage() failed : %lu\n"), GetLastError());
      }
   }
   else
   {
      _ftprintf(stderr, _T("%s : %s\n"), message, buffer);
      LocalFree(buffer), buffer = NULL;
   }
}
 
static void DisplayAuthAlgorithm(DOT11_AUTH_ALGORITHM authAlgorithm)
{
   LPCTSTR algo = NULL;
 
   switch(authAlgorithm)
   {
      case DOT11_AUTH_ALGO_80211_OPEN :         algo = _T("IEEE 802.11 Open System"); break;
      case DOT11_AUTH_ALGO_80211_SHARED_KEY :   algo = _T("802.11 Shared Key"); break;
      case DOT11_AUTH_ALGO_WPA :                algo = _T("WPA"); break;
      case DOT11_AUTH_ALGO_WPA_PSK :            algo = _T("WPA-PSK"); break;
      case DOT11_AUTH_ALGO_WPA_NONE :           algo = _T("not supported"); break;
      case DOT11_AUTH_ALGO_RSNA :               algo = _T("802.11i RSNA (WPA2)"); break;
      case DOT11_AUTH_ALGO_RSNA_PSK :           algo = _T(" 802.11i RSNA PSK (WPA2-PSK)"); break;
   }
 
   if(algo == NULL)
   {
      if(authAlgorithm >= DOT11_AUTH_ALGO_IHV_START && authAlgorithm <= DOT11_AUTH_ALGO_IHV_END)
      {
         algo = _T("Proprietary auth algorithm");
      }
      else
      {
         algo = _T("Unknown algorithm");
      }
   }
 
   _tprintf(_T("\t\tAuth Algorithm is [%s]\n"), algo);
}
 
static LPCTSTR PhysicalTypeToString(DOT11_PHY_TYPE physicalType)
{
   LPCTSTR type = NULL;
 
   switch(physicalType)
   {
      case dot11_phy_type_unknown :    type = _T("unknown or uninitialized PHY type"); break;
      case dot11_phy_type_fhss :       type = _T("frequency-hopping spread-spectrum (FHSS) PHY. Bluetooth devices can use FHSS or an adaptation of FHSS"); break;
      case dot11_phy_type_dsss :       type = _T("direct sequence spread spectrum (DSSS) PHY type"); break;
      case dot11_phy_type_irbaseband : type = _T("infrared (IR) baseband PHY type"); break;
      case dot11_phy_type_ofdm :       type = _T("orthogonal frequency division multiplexing (OFDM) PHY type. 802.11a devices can use OFDM"); break;
      case dot11_phy_type_hrdsss :     type = _T("high-rate DSSS (HRDSSS) PHY type"); break;
      case dot11_phy_type_erp :        type = _T("extended rate PHY type (ERP). 802.11g devices can use ERP"); break;
      case dot11_phy_type_ht :         type = _T("unknown or uninitialized PHY type"); break;
   }
 
   if(type == NULL)
   {
      if(physicalType >= dot11_phy_type_IHV_start && physicalType <= dot11_phy_type_IHV_end)
      {
         type = _T("Proprietary Physical Type");
      }
      else
      {
         type = _T("Unknown Physical Type");
      }
   }
 
   return type;
}
 
static LPCTSTR StateToString(WLAN_INTERFACE_STATE state)
{
   LPCTSTR status = NULL;
 
   switch(state)
   {
      case wlan_interface_state_not_ready :              status = _T("not ready");              break;
      case wlan_interface_state_connected :              status = _T("connected");              break;
      case wlan_interface_state_ad_hoc_network_formed :  status = _T("No peer has connected");  break;
      case wlan_interface_state_disconnecting :          status = _T("disconnecting");          break;
      case wlan_interface_state_disconnected :           status = _T("disconnected");           break;
      case wlan_interface_state_associating :            status = _T("associating");            break;
      case wlan_interface_state_discovering :            status = _T("discovering");            break;
      case wlan_interface_state_authenticating :         status = _T("authenticating");         break;
      default :                                          status = _T("unknown state");          break;
   }
 
   return status;
}
 
static void DisplayBssType(DOT11_BSS_TYPE bssType)
{
   LPCTSTR type;
 
   if(bssType == dot11_BSS_type_infrastructure)
   {
      type = _T("infastructure");
   }
   else if(bssType == dot11_BSS_type_independent)
   {
      type = _T("ad hoc");
   }
   else if(bssType == dot11_BSS_type_any)
   {
      type = _T("infastructure, ad hoc");
   }
   else
   {
      type = _T("unknown");
   }
 
   _tprintf(_T("\t\tNetwork type is [%s]\n"), type);
}
 
static void DisplayProfileName(BOOL hasProfile, LPCWSTR profileName)
{
   if(hasProfile)
   {
      _tprintf(_T("\t\tProfile name is %ws\n"), profileName);
   }
   else
   {
      _putts(_T("\t\tThere is no profile associated with this network"));
   }
}
 
static void DisplaySSID(PDOT11_SSID ssid)
{
   _tprintf(_T("\t\tSSID is [%.*hs]\n"), (int)(ssid->uSSIDLength), ssid->ucSSID);
}
 
static void DisplayBSSID(HANDLE clientHandle, const GUID * interfaceGuid)
{
   DWORD size = 0;
   PWLAN_CONNECTION_ATTRIBUTES attributes = NULL;
   DWORD lastError = WlanQueryInterface(clientHandle, interfaceGuid, wlan_intf_opcode_current_connection, NULL, &size, (PVOID*)&attributes, NULL);
 
   if(lastError == ERROR_SUCCESS)
   {
      PUCHAR bssid = attributes->wlanAssociationAttributes.dot11Bssid;
      _tprintf(_T("\t\tBSSID is %02X-%02X-%02X-%02X-%02X-%02X\n"), 
               bssid[0], bssid[1], bssid[2], bssid[3], bssid[4], bssid[5]);
      WlanFreeMemory(attributes), attributes = NULL;
   }
   else
   {
      DisplayError(_T("Error in the WlanQueryInterface() function call"), lastError);
   }
}
 
static void DisplayConnectability(BOOL isConnectable, WLAN_REASON_CODE reasonCode)
{
   if(isConnectable)
   {
      _putts(_T("\t\tNetwork is connectable"));
   }
   else
   {
      WCHAR reason[128];
      DWORD lastError = WlanReasonCodeToString(reasonCode, _countof(reason), reason, NULL);
 
      if(lastError == ERROR_SUCCESS)
      {
         _tprintf(_T("\t\tNetwork is not connectable : %ws\n"), reason);
      }
      else
      {
         DisplayError(_T("Error in the WlanReasonCodeToString() function call"), lastError);
      }
   }
}
 
static void DisplayPhyTypes(HANDLE clientHandle, const GUID * interfaceGuid, WLAN_AVAILABLE_NETWORK * info)
{
   ULONG type = 0;
   PWLAN_BSS_LIST list = NULL;
   DWORD lastError;
 
   if(info->uNumberOfPhyTypes > 1)
   {
      _tprintf(_T("\t\tThere are %lu physical types supported :"), info->uNumberOfPhyTypes);
   }
   else
   {
      _putts(_T("\t\tThere is 1 physical types supported :"));
   }
 
   for(; type < info->uNumberOfPhyTypes; type++)
   {
      _tprintf(_T("\t\t\t- %s\n"), PhysicalTypeToString(info->dot11PhyTypes[type]));
   }
 
   lastError = WlanGetNetworkBssList(clientHandle, interfaceGuid, &info->dot11Ssid, info->dot11BssType, 
                                     info->bSecurityEnabled, NULL, &list);
 
   if(lastError == ERROR_SUCCESS)
   {
 
      if(list->dwNumberOfItems == 1)
      {
         _tprintf(_T("\t\tPhysical type used for this network : %s\n"), 
                  PhysicalTypeToString(list->wlanBssEntries[0].dot11BssPhyType));
      }
 
       WlanFreeMemory(list), list = NULL;
   }
   else if(lastError != ERROR_NOT_SUPPORTED)
   {
      DisplayError(_T("Error in the WlanGetNetworkBssList() function call"), lastError);
   }
}
 
static void DisplayStatus(BOOL isConnected)
{
   _tprintf(_T("\t\tStatus : %s\n"), isConnected ? _T("connected") : _T("disconnected"));
}
 
static void DisplaySecurity(BOOL isSecure, DOT11_CIPHER_ALGORITHM cipherAlgorithm)
{
   if(isSecure)
   {
      LPCTSTR algo = NULL;
 
      switch(cipherAlgorithm)
      {
         case DOT11_CIPHER_ALGO_NONE :          algo = _T("No cipher");                   break;
         case DOT11_CIPHER_ALGO_WEP40 :         algo = _T("WEP (40 bits cipher key)");    break;
         case DOT11_CIPHER_ALGO_TKIP :          algo = _T("TKIP");                        break;
         case DOT11_CIPHER_ALGO_CCMP :          algo = _T("AES-CCMP");                    break;
         case DOT11_CIPHER_ALGO_WEP104 :        algo = _T("WEP (104 bits cipher key)");   break;
         case DOT11_CIPHER_ALGO_WEP :           algo = _T("WEP");                         break;
         case DOT11_CIPHER_ALGO_WPA_USE_GROUP : algo = _T("Use Group Key cipher suite");  break;
      }
 
      if(algo == NULL)
      {
         if(cipherAlgorithm >= DOT11_CIPHER_ALGO_IHV_START && cipherAlgorithm <= DOT11_CIPHER_ALGO_IHV_END)
         {
            algo = _T("Proprietary cipher algorithm");
         }
         else
         {
            algo = _T("Unknown algorithm");
         }
      }
 
      _tprintf(_T("\t\tSecurity is enbled : %s\n"), algo);
   }
   else
   {
      _putts(_T("\t\tSecurity is disabled"));
   }
}
 
static void DisplaySignalStrength(WLAN_SIGNAL_QUALITY quality)
{
   _tprintf(_T("\t\tSignal strength is %lu%%\n"), quality);
}
 
static void EnumerateNetwork(HANDLE clientHandle, const GUID * interfaceGuid)
{
   WLAN_AVAILABLE_NETWORK_LIST * networkList = NULL;
   DWORD lastError = WlanGetAvailableNetworkList(clientHandle, interfaceGuid, 0, NULL, &networkList);
 
   if(lastError != ERROR_SUCCESS)
   {
      DisplayError(_T("Error in the WlanGetAvailableNetworkList() function call"), lastError);
   }
   else
   {
      _tprintf(_T("\tThere are %lu Wifi network\n"), networkList->dwNumberOfItems);
 
      for(networkList->dwIndex = 0; networkList->dwIndex != networkList->dwNumberOfItems; networkList->dwIndex++)
      { 
         WLAN_AVAILABLE_NETWORK * info = &networkList->Network[networkList->dwIndex];
 
         _tprintf(_T("\n\t\tNetwork %lu\n"), networkList->dwIndex);
         DisplayStatus(info->dwFlags & WLAN_AVAILABLE_NETWORK_CONNECTED);
         DisplayProfileName(info->dwFlags & WLAN_AVAILABLE_NETWORK_HAS_PROFILE, info->strProfileName);
         DisplaySSID(&info->dot11Ssid);
         DisplayBssType(info->dot11BssType);
         DisplayBSSID(clientHandle, interfaceGuid);
         DisplayConnectability(info->bNetworkConnectable, info->wlanNotConnectableReason);
         DisplayPhyTypes(clientHandle, interfaceGuid, info);
         DisplaySecurity(info->bSecurityEnabled, info->dot11DefaultCipherAlgorithm);
         DisplaySignalStrength(info->wlanSignalQuality);
         DisplayAuthAlgorithm(info->dot11DefaultAuthAlgorithm);
      }
 
      WlanFreeMemory(networkList), networkList = NULL;
   }
}
 
static void EnumerateInterface(HANDLE clientHandle)
{
   WLAN_INTERFACE_INFO_LIST * interfaceList = NULL;
   DWORD lastError = WlanEnumInterfaces(clientHandle, NULL, &interfaceList);
 
   if(lastError != ERROR_SUCCESS)
   {
      DisplayError(_T("Error in the WlanEnumInterfaces() function call"), lastError);
   }
   else
   {
      DWORD item = 0;
      _tprintf(_T("There are %d Wifi interface\n"), interfaceList->dwNumberOfItems);
 
      for(; item != interfaceList->dwNumberOfItems; item++)
      {
         WLAN_INTERFACE_INFO * info = &interfaceList->InterfaceInfo[item];
         GUID * guid = &info->InterfaceGuid;
         LPOLESTR guid_str = NULL;
 
         if(StringFromCLSID(guid, &guid_str) == S_OK)
         {
            _tprintf(_T("Interface %lu\n")
                     _T("\tThe Wifi interface GUID is [%ws]\n")
                     _T("\tThe Wifi interface description is [%ws]\n")
                     _T("\tThe Wifi interface state is [%s]\n"), 
                  item, guid_str, info->strInterfaceDescription, StateToString(info->isState));
 
            CoTaskMemFree(guid_str), guid_str = NULL;
         }
         else
         {
            DisplayError(_T("Error in the StringFromCLSID() function call"), ERROR_NOT_ENOUGH_MEMORY);
         }
 
         EnumerateNetwork(clientHandle, guid);
      }
 
      WlanFreeMemory(interfaceList), interfaceList = NULL;
   }
}
 
int _tmain()
{
   DWORD negotiatedVersion = 0;
   HANDLE clientHandle = NULL;
   DWORD lastError;
 
   _tsetlocale(LC_ALL, _T(""));
 
   lastError = WlanOpenHandle(WLAN_API_VERSION, NULL, &negotiatedVersion, &clientHandle); /* open the Wifi box */
 
   if(lastError != ERROR_SUCCESS)
   {
      DisplayError(_T("Error in the WlanOpenHandle() function call"), lastError);
   }
   else
   {
      _tprintf(_T("Asked version to WLAN interface is %lu, negociated version is %lu\n"), 
               WLAN_API_VERSION, negotiatedVersion);
 
      EnumerateInterface(clientHandle);
 
      lastError = WlanCloseHandle(clientHandle, NULL);
 
      if(lastError != ERROR_SUCCESS)
      {
         DisplayError(_T("Error in the WlanCloseHandle() function call"), lastError);
      }
   }
 
   return 0;
}

Cordialement.

**ram-0000** · 30/09/2010, 19h43

L'article a été mis à jour, merci pour les modification du code

**trantor** · 26/10/2010, 15h54

Excellent tutoriel pour une introduction à l’ « API Microsoft Native Wifi ».

Pour ma part j’ai été amené à utiliser cette API pour développer un produit assurant la gestion et les connexions réseau sans fil. Le problème que j’ai rencontré est que cette API ne semble pas exister pour la version de Windows XP 64 bits SP2. En fait sous cette version de Windows la dll Wlanapi.dll n’est pas présente et c’est cette dll qui implémente l’ « API Microsoft Native Wifi ».

Ma question est donc de savoir s’il y a une possibilité d’utiliser l’ « API Microsoft Native Wifi » sous Windows XP 64 bits autrement qu’avec la dll Wlanapi.dll. Je pense que cela devrait être possible, car le service « Wireless Zero Configuration » existe sous cet OS.

Toute suggestion sera la bienvenue.

**Whaouu** · 28/12/2010, 11h39

Bonjour, à tous,

J'ai voulu tester l'exemple dans Visual Studio C++, mais j'obtiens ce message d'erreur à la compilation :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
c:\documents and settings\administrateur\mes documents\visual studio 2010\projects\wlanapi2\wlanapi2\main.cpp(340): error C2664: 'StringFromCLSID'*: impossible de convertir le paramètre 1 de 'GUID *' en 'const IID &'
          Raison*: impossible de convertir de 'GUID *' en 'const IID'
          Aucun constructeur n'a pu prendre le type de source, ou la résolution de la surcharge du constructeur était ambiguë

Quelqu'un pourrait-il m'aider à résoudre ce problème ?

Merci par avance.

**ram-0000** · 30/12/2010, 15h52

Peut être une différence entre les includes fournis par Visual Studio et ceux du SDK.

Si je fais un click droit sur l'appel de la fonction (sous Visual Studio) et que je selectionne l'option "Atteindre la définition", cela ouvre le fichiers objbase.h du répertoire c:\program files\microsoft sdks\windows\v7.0\include\ donc les includes du SDK.

As tu le SDK installé ?

**Whaouu** · 09/01/2011, 12h31

Bonjour, ram-0000,

Merci beaucoup pour ta réponse et toutes mes excuses pour la mienne tardive.

J'ai installé la version :

Microsoft Visual Studio 2010
Version 10.0.30319.1 RTMRel
Microsoft .NET Framework
Version 4.0.30319 RTMRel

Version installée*: VC Express

Microsoft Visual C++ 2010 01013-169-2610014-70799
Microsoft Visual C++ 2010

Chez moi "ObjBase.h" se trouve dans "C:\Program Files\Microsoft SDKs\Windows\v7.0A\Include".

Je dois installer un autre SDK que celui qui fournis par Microsoft ?

**ram-0000** · 09/01/2011, 12h43

Visiblement, tu n'utilises pas tout à fait la même version que moi.

J'utilise la version "Windows® Software Development Kit (SDK) for Windows 7 and .NET Framework 3.5 Service Pack 1" qui s'installe dans le répertoire "C:\Program Files\Microsoft SDKs\Windows\v7.0" mais cela ne devrait pas être un soucis, tu as tout simplement une version postérieure à la mienne.

Par contre, il faut que tu vérifies dans les options de Visual Studio que les répertoires du SDK sont bien pris en compte avant les répertoires Visual Studio.

Pour cela, il faut ouvrir dans Visual Studio, le menu "Outils / Options", sélectionner la branche "Projets et solutions" à gauche dans la fenêtre puis la sous-branche "Répertoire de VC++" et vérifier que pour les "Fichiers includes" et les "Fichiers bibliothèques" (en haut à droite de la fenêtre), les répertoires du SDK sont affichés avant ceux de Visual Studio. Si ce n'est pas le cas, il faut modifier leur ordre (avec les flèches "haut" et "bas" en haut à droite de la fenêtre).

**Whaouu** · 09/01/2011, 20h03

Visiblement ce système de paramétrage a été modifié :

http://msdn.microsoft.com/fr-fr/library/ee855621.aspx

J'ai remplacé :

$(VCInstallDir)include;$(VCInstallDir)atlmfc\include;$(WindowsSdkDir)include;$(FrameworkSDKDir)\include;

Par :

$(WindowsSdkDir)include;$(VCInstallDir)include;$(VCInstallDir)atlmfc\include;$(FrameworkSDKDir)\include;

Malheureusement le problème persiste.