RAPI初始化算法和SAMPLE CODE

作者：Walzer
日期：2005.12.12

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;
    }
}