学步园

先介绍下GPRS，

要使用GPRS的函数之前，先导入库

#include <Connmgr.h>
#pragma comment ( lib, "Cellcore.lib" )

介绍下connection manager的一些函数：

1.       客户端建立GPRS连接 API

客户端开发采用 EVC4.0进行开发，主要讲解的类库为Connection Manager 系列API，客户端在进行GPRS拨号连接时将使用下文所介绍的API。

Connection Manager(本人译为 连接管理器，此对象为一系列API的集合) 系列API的主要目的是为了集中管理基于Windows Mobile系列的设备网络连接的建立与维护。移动应用程序使用 连接管理器API去建立或规划一个网络连接，而连接管理器则掌控连接过程中的所有状态信息.应用程序在要发起一个连接(比如Internet)，只要简单的告知连接管理器就OK了。

当一个应用程序发起一个网络连接的请求时，连接管理器首先从连接服务提供商（CSPS）处获取所有可能的连接信息，然后连接管理器会从这一系列连接信息中根据开销，延迟、带宽等因素来选择一个最佳的连接，最后连接管理器将被请求的连接排入队列，然后在一个适合的时间使用CSPS来建立连接。    

【API函数】：

a)       ConnMgrApiReadyEvent（）函数
函数原型：HANDLE WINAPI ConnMgrApiReadyEvent();
利用此函数来我们可以返回一个连接事件的句柄 ，注意在的得到句柄后要记得及时释放

b)       ConnMgrConnectionStatus（）函数
函数原型：
HRESULT WINAPI ConnMgrConnectionStatus(HANDLE hConnection,DWORD * pdwStatus );利用此函数的返回值pdwStatus，我们可以得到很多的关于连接的信息，例如如果我们连接成功将返回CONNMGR_STATUS_CONNECTED，断开连接将返回CONNMGR_STATUS_DISCONNECTED,他的返回状态信息非常丰富，有14中之多，完全可以满足我们的应用需要；

c)        ConnMgrEnumDestinations()函数
函数原型：
HRESULT WINAPI ConnMgrEnumDestinations(int nIndex,CONNMGR_DESTINATION_INFO * pDestInfo )；
一般我们的PDA在连接GPRS时都有好几个连接，利用此函数我们可以枚举出所有可用的连接，然后再对挑选的连接进行筛选得到一个最佳连接

接下来讲两个很重要的函数，我们将利用两个函数中的一个来发起连接，他们是：

d)       ConnMgrEstablishConnection()和ConnMgrEstablishConnectionSync()函数，这两个函数一个用于发起一个异步连接请求，一个用于同步请求，使用异步连接请求我们可以在发起连接后立即返回，而使用同步请求客户端将一直被阻塞知道函数返回确认连接，关于异步和同步我就不再叙述；
它们的原型依次为：
HRESULT WINAPI ConnMgrEstablishConnection( CONNMGR_CONNECTIONINFO * pConnInfo, HANDLE * phConnection );
HRESULT WINAPI ConnMgrEstablishConnectionSync(   CONNMGR_CONNECTIONINFO * pConnInfo, HANDLE * phConnection,    DWORD dwTimeout, DWORD * pdwStatus );
      可以看到两个函数的第一个参数都为一个CONNMGR_CONNECTIONINFO对象，此对象为一个结构体，它保存了客户端发起连接请求的一系列信息，因此，在我们调用此函数时必须构造一个该对象，然后将其作为参数传入连接函数中。这里很有必要讲一下该结构体，该结构体的原型如下：
typedef struct _CONNMGR_CONNECTIONINFO
{
     DWORD cbSize;   DWORD dwParams;DWORD dwFlags;

           DWORD dwPriority;BOOL bExclusive;BOOL bDisabled;GUID guidDestNet;

           HWND hWnd;  UINT uMsg; LPARAM lParam;ULONG ulMaxCost;  ULONG ulMinRcvBw;  
      ULONG ulMaxConnLatency;

        } CONNMGR_CONNECTIONINFO;
其中参数dwFlags用于指定我们的接入点，比如我们常说的CMNER和CMWAP，而参数GUID则标志了我们对应于每个接入点的全球唯一标志符，关于如何得到或者查看GUID，我们可以在“/Program Files/Windows CE Tools/wce420/POCKET PC 2003/Include/Armv4”目录下查看connmgr.h文件，里面包含了各个接入点的GUID，例如：

CMNET 为：(0x436ef144, 0xb4fb, 0x4863, 0xa0, 0x41, 0x8f, 0x90, 0x5a, 0x62, 0xc5, 0x72)

 CMWAP为：0x7022e968, 0x5a97, 0x4051, 0xbc, 0x1c, 0xc5, 0x78, 0xe2, 0xfb, 0xa5, 0xd9

如果想更进一步了解，我们还可以通过查看注册表方式来查看PDA上连接管理器的相关连接信息，在PPC 2003中注册表路径为：

[HKEY_LOCAL_MACHINE/Comm/ConnMgr]，如下图所示：

现在开始实践下

手机开通GPRS以后，我们的socket 程序还不能直接建立网络连接，需要用连接管理器来获取当前可用连接，并自动选择一个最佳的连接途径，然后启用这个连接，在连接启动成功以后再用socket 进行网络连接方可正常进行。大概GPRS拨号和连接过程就是在这里自动进行的吧。源代码中封装了一个连接管理的类和测试代码，可以清楚地看到Windows Mobile 在socket 编程之前到底需要做什么样的操作。

首先需要枚举当前可用的连接

void CConnectManager::EnumNetIdentifier ( CStringArray &StrAry )<br /> {<br /> CONNMGR_DESTINATION_INFO networkDestInfo = {0};</p> <p> // 得到网络列表<br /> for ( DWORD dwEnumIndex=0; ; dwEnumIndex++ )<br /> {<br /> memset ( &networkDestInfo, 0, sizeof(CONNMGR_DESTINATION_INFO) );<br /> if ( ConnMgrEnumDestinations ( dwEnumIndex, &networkDestInfo ) == E_FAIL )<br /> {<br /> break;<br /> }<br /> StrAry.Add ( networkDestInfo.szDescription );<br /> }<br /> }<br />

接下来找到“Internet”这个连接，可用远程URL映射的方式来完成，这样可以让系统自动选取一个最好的连接。

int CConnectManager::MapURLAndGUID ( LPCTSTR lpszURL, OUT GUID &guidNetworkObject, OUT CString *pcsDesc/*=NULL*/ )<br /> {<br /> if ( !lpszURL || lstrlen(lpszURL) < 1 )<br /> return FALSE;</p> <p> memset ( &guidNetworkObject, 0, sizeof(GUID) );<br /> int nIndex = 0;<br /> HRESULT hResult = ConnMgrMapURL ( lpszURL, &guidNetworkObject, (DWORD*)&nIndex );<br /> if ( FAILED(hResult) )<br /> {<br /> nIndex = -1;<br /> DWORD dwLastError = GetLastError ();<br /> AfxMessageBox ( _T("Could not map a request to a network identifier") );<br /> }<br /> else<br /> {<br /> if ( pcsDesc )<br /> {<br /> CONNMGR_DESTINATION_INFO DestInfo = {0};<br /> if ( SUCCEEDED(ConnMgrEnumDestinations(nIndex, &DestInfo)) )<br /> {<br /> *pcsDesc = DestInfo.szDescription;<br /> }<br /> }<br /> }</p> <p> return nIndex;<br /> }<br />

以下代码是用来启用指定编号的连接

BOOL CConnectManager::EstablishConnection ( DWORD dwIndex )<br /> {<br /> ReleaseConnection ();</p> <p> // 得到正确的连接信息<br /> CONNMGR_DESTINATION_INFO DestInfo = {0};<br /> HRESULT hResult = ConnMgrEnumDestinations(dwIndex, &DestInfo);<br /> BOOL bRet = FALSE;<br /> if(SUCCEEDED(hResult))<br /> {<br /> // 初始化连接结构<br /> CONNMGR_CONNECTIONINFO ConnInfo;</p> <p> ZeroMemory(&ConnInfo, sizeof(ConnInfo));<br /> ConnInfo.cbSize = sizeof(ConnInfo);<br /> ConnInfo.dwParams = CONNMGR_PARAM_GUIDDESTNET;<br /> ConnInfo.dwFlags = CONNMGR_FLAG_PROXY_HTTP |<br /> CONNMGR_FLAG_PROXY_WAP |<br /> CONNMGR_FLAG_PROXY_SOCKS4 |<br /> CONNMGR_FLAG_PROXY_SOCKS5;<br /> ConnInfo.dwPriority = CONNMGR_PRIORITY_USERINTERACTIVE;<br /> ConnInfo.guidDestNet = DestInfo.guid;<br /> ConnInfo.bExclusive = FALSE;<br /> ConnInfo.bDisabled = FALSE;</p> <p> DWORD dwStatus = 0;<br /> hResult = ConnMgrEstablishConnectionSync(&ConnInfo, &m_hConnection, 10*1000, &dwStatus );<br /> if(FAILED(hResult))<br /> {<br /> m_hConnection = NULL;<br /> }<br /> else bRet = TRUE;<br /> }</p> <p> return bRet;<br /> }<br />

为了确保连接是否真正可用，需要检测连接状态，在规定的时间内如果未取得“连接成功”的状态，则认为连接未能正常启用，可能需要配置手机的连接管理器界面

BOOL CConnectManager::WaitForConnected ( int nTimeoutSec, DWORD *pdwStatus/*=NULL*/ )<br /> {<br /> DWORD dwStartTime = GetTickCount ();<br /> BOOL bRet = FALSE;<br /> while ( GetTickCount ()-dwStartTime < (DWORD)nTimeoutSec * 1000 )<br /> {<br /> if ( m_hConnection )<br /> {<br /> DWORD dwStatus = 0;<br /> HRESULT hr = ConnMgrConnectionStatus ( m_hConnection, &dwStatus );<br /> if ( pdwStatus ) *pdwStatus = dwStatus;<br /> if ( SUCCEEDED(hr) )<br /> {<br /> if ( dwStatus == CONNMGR_STATUS_CONNECTED )<br /> {<br /> bRet = TRUE;<br /> break;<br /> }<br /> }<br /> }<br /> Sleep ( 100 );<br /> }</p> <p> return bRet;<br /> }<br />

至此，我们的连接启用工作已经做完了，我们可以用我们熟悉的 socket 来编写网络通信程序了。下面是一个测试 socket 测试网络连接是否能正常建立的例子：

SetWaitCursor ();<br /> CSocket sock;<br /> sock.Create ();<br /> if ( sock.Connect ( _T("www.baidu.com"), 80 ) )<br /> {<br /> RestoreCursor ();<br /> AfxMessageBox ( _T("Connect to www.baidu.com successfully"), MB_ICONINFORMATION );<br /> }<br /> else<br /> {<br /> RestoreCursor ();<br /> AfxMessageBox ( _T("Connect to www.baidu.com failed") );<br /> }<br />

具体的文章在：http://www.vckbase.com/document/viewdoc/?id=1803

在这里里面有DestId一项，就对应着我们久违的GUID

e)       ConnMgrReleaseConnection函数
我们在上一步中建立连接后我们将得到一个连接句柄，在重新开始一个新的连接或者断开连接都要调用此函数来释放掉之前创建的连接，它的原型为：
HRESULT WINAPI ConnMgrReleaseConnection( HANDLE hConnection,BOOL bCache );

【连接管理API大致使用步骤】：

首先我们利用ConnMgrApiReadyEvent()函数来确认是否有可用连接，如果有可用连接我们则利用ConnMgrEnumDestinations()函数枚举所有可用连接，然后遍历所有连接调用我们的同步或异步连接方法ConnMgrEstablishConnectionSync()与ConnMgrEstablishConnection()来发起连接，一旦连接成功后我们就可以进行我们伟大的下一步了，就是和我们的服务器进行通信。

在Destinations一项中就对应我们所有可用的网络连接，这个跟用ConnMgrEnumDestinations()方法得到的是一样的效果，在默认Internet设置中我们将看到CMNET的GUID，如下所示：