【WindowsCE 】WinCE WIFI 无线网卡的配置和建立连接

    在 Windows CE 下自带有无线网卡的配置和连接程序,这篇文章就来谈一下如何用那么可以利用微软自带的WZC函数来重新编写一个独立于系统的WIFI连接程序.

     下面是一整套通过WZC函数连接无线网的程序，我自己测试后保证在系统下是可以运行.大家可以参考一下。

一、非常重要的库文件。

    #include <eaputil.h> 

    #include <pm.h>   

    #include <wzcsapi.h>   

    #include <iphlpapi.h>    

    #pragma comment(lib,"Iphlpapi.lib") 

    #pragma comment(lib,"Wzcsapi.lib"）

    #pragma comment(lib,"cclib.lib")  

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

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了。