RAPI初始化算法和SAMPLE CODE

RAPI全写为Remote Application Interface, 就是PC端调用这组API, 通过ActiveSync来操作TARGET端WindowsCE作业. 这个功能估计以后在WINCE或WIN MOBILE的应用上会用到许多

我今天修改了同事留下的Updateboot.exe的代码, 改进蓝牙读写的模块. 这个地方我们用到了RAPI, 看一下他们在程序中初始化RAPI的做法

 HRESULT hRapiResult;
 hRapiResult = CeRapiInit();
 if(hRapiResult != S_OK)
 {
     m_ValueEdit.SetWindowText((LPCTSTR)"初始化RAPI失败");
     return;
 }

看起来是平淡无奇, 实际上单步一下就可以发现运行到CeRapiInit()时, 程序就BLOCK在这里了，死活走不下去, 并没有达到 if(hRapiResult != S_OK)的预期目的. 我查了一下CeRapiInit()的说明:

A call to CeRapiInit does not return until the connection is made, an error occurs, or another thread calls CeRapiUninit.

也就是说像我现在并没有把板子和PC相连并启动ACTIVE SYNC时, 这个CeRapiInit()是肯定赖着不走了, 程序会死在这里. (鄙视一下谁写的代码，这个坑好大啊)  因此想到了重新创立个等待进程调用CeRapiUninit来干掉它. 不过这样做显然不厚道, 创立进程需要占用更多的内存. 所以用了上句说明的下半段:

The CeRapiInitEx function does not block the calling thread. Instead, it uses an event to signal when initialization is complete.

建立个事件, 用WaitForSingleObject来等他, 超时就BYEBYE了. 贡献自己写的如下代码, 以后RAPI INIT可以参考

BOOL RapiInitialzation()
{
    RAPIINIT struRapiInit;    // 这个是CeRapiInitEx函数要求的入口参数
    DWORD dwWaitResult  =   0 ;   // 等待初始化完成事件的变量
    HRESULT hRapiResult  =  NULL;  // CeRapiInitEx的返回HANDLE

     if  ( m_bRapiInitFlag  ==  FALSE )  // 全局的一个FLAG,如果初始化过就不再重复了
    {
        struRapiInit.cbSize  =   sizeof (RAPIINIT);   // 填满该结构体仅有的三个成员
        struRapiInit.hrRapiInit  =  NULL;   // 明知是输出参数也顺手填一下, 我以前吃过亏, 惊弓之鸟
        struRapiInit.heRapiInit  =  NULL;

        hRapiResult  =  CeRapiInitEx( & struRapiInit);   // 关键点

        m_ValueEdit.SetWindowText((LPCTSTR) " Wait 2 second for RapiInit " );  // 后面2秒程序要顿一下了, 得告诉用户.  m_ValutEdit和对话框里一个IDC_STATIC关联了.
        dwWaitResult  =  WaitForSingleObject(struRapiInit.heRapiInit,  2000 );   // 关键点

         if ( hRapiResult  ==  S_OK  &&  
            struRapiInit.hrRapiInit  ==  S_OK  &&
            dwWaitResult  !=  WAIT_TIMEOUT)     // 保守起见, 三个返回值都判断
        {
           m_bRapiInitFlag  =  TRUE;
            return  TRUE;
        }
         else
        {
            m_ValueEdit.SetWindowText((LPCTSTR) " The initialization of RAPI falied, you need to install an ActiveSync or connect the IPTV to PC " );    // 一般是没连接导致, 当然也可能用户没装ActiveSync
            return  FALSE;
        }
    }
     else
    {
         m_bRapiInitFlag  =  TRUE;
          return  TRUE;
    }
}