如何在WM上创建接入点

最近需要做点与网络连接相关的东西，研究了下WM上创建接入点的方法，把一些自己对该知识点的理解和一些代码片段记录下来。

【相关知识点】
接入点对应的注册表项：
1.HKEY_CURRENT_USER/Comm/RasBook
2.HKEY_LOCAL_MACHINE/Comm/ConnMgr/Providers/{7C4B7A38-5FF7-4bc1-80F6-5DA7870BB1AA}/Connections

注册表项：
HKEY_CURRENT_USER/Comm/RasBook

HKEY_LOCAL_MACHINE/Comm/ConnMgr/Providers/{7C4B7A38-5FF7-4bc1-80F6-5DA7870BB1AA}/Connections

 

RasBook 注册表示例

 

Connections注册表示例

OMA Client Provisioning XML

 

 

【创建接入点】
方法一：RasSetEntryProperties
方法二：DMProcessConfigXML

 

示例代码一：(创建一个Modern拨号连接)
…….
rc = RasValidateEntryName(NULL, entryName);
    if (rc != ERROR_SUCCESS)
    {
        if (rc == ERROR_ALREADY_EXISTS)
        {
            // ok, just need to reset the parameters
        }
    }
    memset(&rasEntry, 0, sizeof(RASENTRY));

    // Num values
    rasEntry.dwSize                = sizeof (RASENTRY);
    rasEntry.dwfOptions            = RASEO_DisableLcpExtensions;// |RASEO_ModemLights|RASEO_SwCompression; //RASEO_RemoteDefaultGateway
    // use the PPP addr as the default gateway
    // don't use LCP extension
    // show in tray icon once connected
    // enable software compression
    rasEntry.dwfNetProtocols    = RASNP_Ip;        // TCP/IP
    rasEntry.dwFramingProtocol    = RASFP_Ppp;    // PPP

    // Strings
    strcpy (rasEntry.szAreaCode, _T(""));
    strcpy (rasEntry.szLocalPhoneNumber, _T("1"));
    strcpy (rasEntry.szScript, _T(""));
    strcpy (rasEntry.szAutodialDll, _T(""));
    strcpy (rasEntry.szAutodialFunc, _T(""));
    strcpy (rasEntry.szDeviceType, _T(""));
    strcpy (rasEntry.szDeviceName, _T(""));
    strcpy (rasEntry.szX25PadType,  _T(""));
    strcpy (rasEntry.szX25Address,  _T(""));
    strcpy (rasEntry.szX25Facilities, _T(""));
    strcpy (rasEntry.szX25UserData,  _T(""));
    strcpy (rasEntry.szDeviceType,DEV_TYPE);

    if (get_dev_name(devName, DEV_NAME))
        strcpy (rasEntry.szDeviceName, devName);
    else
        strcpy (rasEntry.szDeviceName, DEV_NAME);

    // Call RAS function
    pszPbkPath = NULL;    // Default phone book
    rc = RasSetEntryProperties(pszPbkPath, entryName, &rasEntry, sizeof (RASENTRY), NULL, 0);
    if (rc)
    {

        rc = RasSetEntryProperties(pszPbkPath, entryName, &rasEntry, sizeof (RASENTRY), NULL, 0);
    }   

    memset(&dialParm, 0, sizeof(RASDIALPARAMS));

    dialParm.dwSize = sizeof (RASDIALPARAMS);

    strcpy (dialParm.szEntryName,  entryName);
    strcpy (dialParm.szPhoneNumber,  _T(""));
    strcpy (dialParm.szCallbackNumber, _T(""));
    strcpy (dialParm.szUserName, userName);
    strcpy (dialParm.szPassword, password);
    strcpy (dialParm.szDomain,  _T(""));

    dwError = RasSetEntryDialParams(pszPbkPath, &dialParm, FALSE);
    ……

注：以上代码只是创建了一个连接，但是在系统连接设置里面不可见（只会在HKEY_CURRENT_USER/Comm/RasBook对应条目下添加相关的注册表项），如果希望其可以在系统连接设置里面可见，需在HKEY_LOCAL_MACHINE/Comm/ConnMgr/Providers/{7C4B7A38-5FF7-4bc1-80F6-5DA7870BB1AA}/Connections对应的条目下添加上述表格中列出的注册表项。如果你只是想在代码中临时使用该接入点，而不希望用户对其进行手动配置，就没有必要添加这些注册表项了。另外以上的例子只是我创建一个Modern拨号连接的参数，要创建其他类型的连接，应该修改对应的参数。

示例代码er： 
    DWORD retVal = 0;

    LPCWSTR strFavoriteXmlFort =
        L"<wap-provisioningdoc>"
        L"<characteristic type=/"CM_Networks/">"
        L" <characteristic type=/"%s/">"
        L" <parm name=/"DestId/" value=/"%s/" />"      // 1
        L" </characteristic>"
        L"</characteristic>"
        L"<characteristic type=/"CM_PPPEntries/"> " //此处的可以根据实际情况选择类型
        L"<characteristic type=/"%s/">"
        L"<parm name=/"DestId/" value=/"%s/"/>"   //此处的DestId是“1”处定义的ID
        L"<parm name=/"CountryCode/" value=/"%s/"/>"
        L"<parm name=/"AreaCode/" value=/"%s/"/>"
        L"<parm name=/"Phone/" value=/"%s/"/>"
        L"<parm name=/"UserName/" value=/"%s/"/>"
        L"<parm name=/"Password/" value=/"%s/"/>"
        L"<parm name=/"Domain/" value=/"%s/"/>"
        L"<parm name=/"DeviceType/" value=/"%s/"/>"  //modem
        L"<parm name=/"DeviceName/" value=/"%s/"/>"
        L"<parm name=/"Enabled/" value=/"%s/"/>"
        L"<parm name=/"RequirePw/" value=/"%s/"/>"
        L"</characteristic>"
        L"</characteristic>"
        L"</wap-provisioningdoc>";
    CString strXml;
    strXml.Format(strFavoriteXmlFort,
                         lpNetWorkName,
                         connInfo->lpDestId,
                         lpConnName,
                         connInfo->lpDestId,
                         connInfo->lpConntryCode,
                         connInfo->lpAreaCode,
                         connInfo->lpPhone,
                         connInfo->lpUserName,
                         connInfo->lpPassword,
                         connInfo->lpDomain,
                         connInfo->lpDeviceType,
                         connInfo->lpDeviceName,
                         connInfo->lpEnabled,
                         connInfo->lpRequirePw
                        );

    LPWSTR pszwXMLout = NULL;
    HRESULT hr = DMProcessConfigXML(strXml, CFGFLAG_PROCESS, &pszwXMLout);
    retVal = hr;

    if ( pszwXMLout )
    {
        delete [] pszwXMLout;
        pszwXMLout = NULL;
    }

    return retVal;

注：以上代码在系统连接里面创建了一个名为“lpNetWorkName”的NetWork项，在该项目下面创建了一个名为“lpConnName”的连接。该连接的类型可以根据实际情况选择不同类型（CM_GPRSEntries，CM_PPPEntries，CM_VPNEntries...），根据实际的网络情况和设备类型选择类型很重要，比如，我在一个只支持3G网络的手机上创建了一个CM_GPRSEntries类型的连接（EntryType不对），这样该连接是不可用的。另，两处的“DestId”一定要为一致，否则该连接在新建的lpNetWorkName项下不可见。

My Site: http://www.xlbren.com