WinCE 5.0 WIFI 无线网卡的配置和建立连接

WinCE 5.0 WIFI 无线网卡的配置和建立连接 

        在 Windows CE 下自带有无线网卡的配置和连接程序，可是我的系统剪裁掉了资源管理器和任务栏，导致自带的无线网卡配置程序不能再使用了，只好自力更生。

        我的环境是 S3C2440 + WinCE 5.0 + VNUWCL5(威盛无线网卡)及驱动程序。使用 Automatic Configuration Functions API

        一、枚举系统中可用的无线网络设备

                下面的函数可以枚举出系统中所有可用的无线网卡设备的GUID，为了简化，我选择第一块可用的无线网卡来操作       

1. BOOL  GetFirstWirelessCard( PTCHAR  pCard)
2. {
3.      if  (!pCard)
4.     {
5.          return  FALSE;
6.     }
9.     INTFS_KEY_TABLE IntfsTable;
10.     IntfsTable.dwNumIntfs = 0;
11.     IntfsTable.pIntfs = NULL;
13.     _tcscpy(pCard, TEXT( "" ));
15.      // 枚举系统中可用的无线网卡
16.      DWORD  dwStatus = WZCEnumInterfaces(NULL, &IntfsTable);
18.      if  (dwStatus != ERROR_SUCCESS)
19.     {
20.         RETAILMSG(DBG_MSG, (TEXT( "WZCEnumInterfaces() error 0x%08X/n" ),dwStatus));
21.          return  FALSE;
22.     }
24.      // 判断无线网卡的数量，可以根据无线网卡数量来枚举出所有可用的无线网卡
25.      if  (!IntfsTable.dwNumIntfs)
26.     {
27.         RETAILMSG(DBG_MSG, (TEXT( "System has no wireless card./n" )));
28.          return  FALSE;
29.     }
31.     _tcscpy(pCard, IntfsTable.pIntfs[0].wszGuid);
33.     LocalFree(IntfsTable.pIntfs);
35.      return  TRUE;
36. }

        二、获取无线网络信息

        获取到了系统可用的无线网卡后，我们就可以利用它的 GUID 号来进行进一步的操作了，首先要做的事情就是得到该无线网卡的信息以及该无线网卡扫描到的 WIFI 网关信息。

        以下函数可以获取到该无线网卡及扫描的到的无线 AP 信息

1. //////////////////////////////////////////////////////////////////////////
2. // pCard: 无线网卡 GUID
3. // pIntf: 无线网卡配置信息结果体
4. // pOutFlags: 网卡配置信息掩码标志
5. //////////////////////////////////////////////////////////////////////////
6. BOOL  GetWirelessCardInfo( PTCHAR  pCard, PINTF_ENTRY_EX pIntf, PDWORD pOutFlags)
7. {
8.      TCHAR  *szWiFiCard = NULL;
10.      // 参数校验
11.      if  (!pCard || !pIntf || !pOutFlags)
12.     {
13.         RETAILMSG(DBG_MSG, (TEXT( "Param Error./n" )));
14.          return  FALSE;
15.     }       
17.     szWiFiCard = pCard;
18.     
19.     *pOutFlags = 0;
20.     
21.      // 初始化无线网卡信息
22.     ZeroMemory(pIntf,  sizeof (INTF_ENTRY_EX));
23.     
24.      // 设置 GUID 号
25.     pIntf->wszGuid = szWiFiCard;
27.      // 查询无线网卡信息
28.      DWORD  dwStatus = WZCQueryInterfaceEx(NULL, INTF_ALL, pIntf, pOutFlags);
30.      if  (dwStatus != ERROR_SUCCESS)
31.     {
32.         RETAILMSG(DBG_MSG, (TEXT( "WZCQueryInterfaceEx() error 0x%08X/n" ), dwStatus));
33.          return  FALSE;
34.     }
35.     
36.      return  TRUE;
37. }

        三、判断连接状态

        我们可以通过无线网卡的状态来判断当前无线网卡是否已经和无线AP建立了连接

1. BOOL  IsAssociated( const  INTF_ENTRY_EX Intf,  const   DWORD  dwOutFlags)
2. {   
3.      if  (dwOutFlags & INTF_BSSID)
4.     {
5.         PRAW_DATA prdMAC = (PRAW_DATA)(&Intf.rdBSSID);
6.         
7.          // 判断 BSSID 的 MAC 地址是否有效来判断是否和无线AP建立了连接
8.          if  (prdMAC == NULL || prdMAC->dwDataLen == 0 || 
9.             (!prdMAC->pData[0] && !prdMAC->pData[1] && !prdMAC->pData[2] &
10.             !prdMAC->pData[3] && !prdMAC->pData[4] && !prdMAC->pData[5]))
11.         {
12.             RETAILMSG(DBG_MSG, (TEXT( "(This wifi card is not associated to any)/n" )));
13.              return  FALSE;
14.         }
15.          else
16.         {
17.             RETAILMSG(DBG_MSG, (TEXT( "(This wifi card is associated state)/n" )));
18.              return  TRUE;
19.         }
20.     }
21.      else
22.     {
23.          return  FALSE;
24.     }   
25. }

        四、获取无线AP信息

        获取了无线网卡的信息后，可以通过无线网卡枚举出当前所有可用的无线AP的SSID名称以及加密模式等等所有可用信息，一下函数可以实现该功能

1. void  GetWirelseeListSSID( const  PRAW_DATA prdBSSIDList,  HWND  hListCtlWnd)
2. {
3.      if  (prdBSSIDList == NULL || prdBSSIDList->dwDataLen  == 0)
4.     {
5.         RETAILMSG(DBG_MSG, (TEXT( "<null> entry./n" )));
6.     }
7.      else
8.     {
9.         PWZC_802_11_CONFIG_LIST pConfigList = (PWZC_802_11_CONFIG_LIST)prdBSSIDList->pData;
11.          //RETAILMSG(DBG_MSG, (TEXT("[%d] entries./n"), pConfigList->NumberOfItems));
13.         uint i;
14.         
15.          // 枚举所有无线AP
16.          for  (i = 0; i < pConfigList->NumberOfItems; i++)
17.         {
18.             PWZC_WLAN_CONFIG pConfig = &(pConfigList->Config[i]);
19.             
20.             RAW_DATA rdBuffer;
21.             rdBuffer.dwDataLen = pConfig->Ssid.SsidLength;
22.             rdBuffer.pData = pConfig->Ssid.Ssid;
23.              TCHAR  tSsid[MAX_PATH];
24.             
25.              // 将 SSID 的 ASCII 码转化成字符串
26.             PrintSSID(&rdBuffer, tSsid);
28.              if  (hListCtlWnd)
29.             {                   
30.                  if  (ListBox_FindString(hListCtlWnd, 0, tSsid) == LB_ERR)
31.                 {
32.                     ListBox_AddString(hListCtlWnd, tSsid);
33.                 }               
34.             }
36.              //RETAILMSG(DBG_MSG, (TEXT("/n"))); 
37.         }
38.     }
39. }

        五、连接到指定的无线AP

1. //////////////////////////////////////////////////////////////////////////
2. // pCard: 无线网卡 GUID
3. // pSSID: 无线AP SSID号
4. // bAdhoc: 是否点对点的 WIFI 连接
5. // ulPrivacy: 加密模式(WEP/WPA....)
6. // ndisMode: 认证模式(Open/Share)
7. // iKeyIndex: 密钥索引(1-4)
8. // pKey: 密码
9. // iEapType: 802.11 认证模式
10. //////////////////////////////////////////////////////////////////////////
11. BOOL  WirelessConnect( PTCHAR  pCard,  PTCHAR  pSSID,  BOOL  bAdhoc,  ULONG  ulPrivacy, NDIS_802_11_AUTHENTICATION_MODE ndisMode,  int  iKeyIndex,  PTCHAR  pKey,  int  iEapType)
12. {
13.      BOOL  bRet = FALSE;
14.     
15.      if  (!pSSID)
16.     {
17.         RETAILMSG(DBG_MSG, (TEXT( "Param Error./n" )));
19.          return  FALSE;
20.     }
21.      else
22.     {
23.         WZC_WLAN_CONFIG wzcConfig;
24.         ZeroMemory(&wzcConfig,  sizeof (WZC_WLAN_CONFIG));
25.         wzcConfig.Length =  sizeof (WZC_WLAN_CONFIG);
26.         wzcConfig.dwCtlFlags = 0;
28.         wzcConfig.Ssid.SsidLength = _tcslen(pSSID);
30.          for  ( UINT  i = 0; i < wzcConfig.Ssid.SsidLength; i++)
31.         {
32.             wzcConfig.Ssid.Ssid[i] = ( CHAR )pSSID[i];
33.         }
34.         
35.          if  (bAdhoc)
36.         {
37.             wzcConfig.InfrastructureMode = Ndis802_11IBSS;
38.         }
39.          else
40.         {
41.             wzcConfig.InfrastructureMode = Ndis802_11Infrastructure;
42.         }
43.         
44.         wzcConfig.AuthenticationMode = ndisMode;
45.         wzcConfig.Privacy = ulPrivacy;
46.         
47.          if  (pKey == NULL || _tcslen(pKey) == 0)
48.         {
49.              // 对密钥进行转换
50.             bRet = InterpretEncryptionKeyValue(wzcConfig, 0, NULL, TRUE);
52.             wzcConfig.EapolParams.dwEapType = iEapType;
53.             wzcConfig.EapolParams.dwEapFlags = EAPOL_ENABLED;
54.             wzcConfig.EapolParams.bEnable8021x  = TRUE;
55.             wzcConfig.EapolParams.dwAuthDataLen = 0;
56.             wzcConfig.EapolParams.pbAuthData = 0;
57.         }
58.          else
59.         {
60.             RETAILMSG(DBG_MSG, (TEXT( "WirelessConnect iKeyIndex = %d./n" ), iKeyIndex));             
61.             bRet = InterpretEncryptionKeyValue(wzcConfig, iKeyIndex, pKey, FALSE);
62.         }
64.          // 连接到指定的无线AP，并将该AP添加到首先无线AP中
65.         AddToPreferredNetworkList(pCard, wzcConfig, pSSID);     
66.     }
67.      return  bRet;
68. }

        六、密钥转换

        输入的密钥需要通过加密方式进行一定的转化，以下函数可以完成改功能

    

1. static   void  EncryptWepKMaterial(IN OUT WZC_WLAN_CONFIG* pwzcConfig)
2. {
3.     BYTE chFakeKeyMaterial[] = { 0x56, 0x09, 0x08, 0x98, 0x4D, 0x08, 0x11, 0x66, 0x42, 0x03, 0x01, 0x67, 0x66 };
4.      for  ( int  i = 0; i < WZCCTL_MAX_WEPK_MATERIAL; i++)
5.         pwzcConfig->KeyMaterial[i] ^= chFakeKeyMaterial[(7*i)%13];
6. }
8. BOOL InterpretEncryptionKeyValue(IN OUT WZC_WLAN_CONFIG& wzcConfig, IN  int  iKeyIndex, IN PTCHAR pKey, IN BOOL bNeed8021X)
9. {   
10.      if (wzcConfig.Privacy == Ndis802_11WEPEnabled)
11.     {       
12.          if (!bNeed8021X && pKey)     
13.         {           
14.             wzcConfig.KeyIndex = iKeyIndex;
15.             wzcConfig.KeyLength = _tcslen(pKey);
16.             
17.              if ((wzcConfig.KeyLength == 5) || (wzcConfig.KeyLength == 13))
18.             {
19.                  for (UINT i=0; i<wzcConfig.KeyLength; i++)
20.                     wzcConfig.KeyMaterial[i] = (UCHAR)pKey[i];
21.             }
22.              else
23.             {
24.                  if ((pKey[0] != TEXT( '0' )) || (pKey[1] != TEXT( 'x' )))
25.                 {                   
26.                     RETAILMSG(DBG_MSG, (TEXT( "Invalid key value./n" ))); 
27.                      return  FALSE;
28.                 }
30.                 pKey += 2;
31.                 wzcConfig.KeyLength = wcslen(pKey);
33.                  if ((wzcConfig.KeyLength != 10) && (wzcConfig.KeyLength != 26))
34.                 {
35.                     RETAILMSG(DBG_MSG, (TEXT( "Invalid key value./n" ))); 
36.                      return  FALSE;
37.                 }
39.                 wzcConfig.KeyLength >>= 1;
41.                  for (UINT i=0; i<wzcConfig.KeyLength; i++)
42.                 {
43.                     wzcConfig.KeyMaterial[i] = (HEX(pKey[2 * i]) << 4) | HEX(pKey[2 * i + 1]);
44.                 }                   
45.             }
47.             EncryptWepKMaterial(&wzcConfig);
49.             wzcConfig.dwCtlFlags |= WZCCTL_WEPK_PRESENT;
50.         }
51.     }
52.      else   if (wzcConfig.Privacy == Ndis802_11Encryption2Enabled
53.         || wzcConfig.Privacy == Ndis802_11Encryption3Enabled)
54.     {       
55.          if (!bNeed8021X)     
56.         {
57.             wzcConfig.KeyLength = wcslen(pKey);
59.              if ((wzcConfig.KeyLength < 8) || (wzcConfig.KeyLength > 63))
60.             {
61.                 RETAILMSG(DBG_MSG, (TEXT( "WPA-PSK/TKIP key should be 8-63 char long string./n" )));  
62.                  return  FALSE;
63.             }
65.              char  szEncryptionKeyValue8[64];  // longest key is 63
66.             memset(szEncryptionKeyValue8, 0,  sizeof (szEncryptionKeyValue8));
68.             WideCharToMultiByte(CP_ACP,
69.                 0,
70.                 pKey,
71.                 wzcConfig.KeyLength + 1,
72.                 szEncryptionKeyValue8,
73.                 wzcConfig.KeyLength + 1,
75.                 NULL,
76.                 NULL);
77.             WZCPassword2Key(&wzcConfig, szEncryptionKeyValue8);
78.             EncryptWepKMaterial(&wzcConfig);
80.             wzcConfig.dwCtlFlags |= WZCCTL_WEPK_XFORMAT
81.                 | WZCCTL_WEPK_PRESENT
82.                 | WZCCTL_ONEX_ENABLED;
83.         }
85.         wzcConfig.EapolParams.dwEapFlags = EAPOL_ENABLED;
86.         wzcConfig.EapolParams.dwEapType = DEFAULT_EAP_TYPE;
87.         wzcConfig.EapolParams.bEnable8021x = TRUE;
88.         wzcConfig.WPAMCastCipher = Ndis802_11Encryption2Enabled;
89.     }
91.      return  TRUE;
92. }

        通过以上操作，完全可以连接到可用的无线AP了，再加上些适当的UI程序，完全可以用来替代 Windows CE 自带的无线配置程序了，我再连接中放置了一个简单的而完整的测试程序，相信大家看了以后都知道怎么操作无线网卡了。

http://download.csdn.net/source/927575