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

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

                下面的函数可以枚举出系统中所有可用的无线网卡设备的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 自带的无线配置程序了，我再连接中放置了一个简单的而完整的测试程序，相信大家看了以后都知道怎么操作无线网卡了。