【COM范例】WM上获取短信内容，AcitiveX控件调用页面JS方法-阿里云开发者社区

　　COM 是 WIN32 系统中最复杂和晦涩，最重要的技术。

　　【备注：以下是个人看法】COM 是比传统的 API 提供方式（*.h, *.lib, *.dll) 更”高“层次的服务标准，从某种意义上说，COM也是一种”API“，但它的使用和实现都要比传统API复杂的多。COM 的宗旨是提供这样的一种标准，使操作系统，独立软件开发商之间以一种标准方式提供交互性服务。COM 相比传统API合作方式相比：两者本质上都提供的二进制代码（编译后产品），前者是基于有组织的，语言中立的具有面向对象特性的标准。后者是零散的，语言相关，面向过程的方式。前者的显著优点是，它的组件是共享式的安装在系统上的一种服务，组件位置对用户是透明的，因此它仅需要在每个客户端部署一份（甚至部署在一台远程计算机）。而后者位置不透明因此未必能够做到这一点。COM 技术使用推出新接口实现升级，以降低对客户端的影响。而传统 API 提供方式有可能在升级时导致DLL版本混乱。

　　由于对语言中立性的追求以及COM的标准，COM 的代码相比普通的 C/C++ 可读性更低，但也具有一定规律性。ATL中提供了一些辅助类来降低 COM 代码的使用难度。

　　这里是两个例子。

　　【例子1】：在 Windows Mobile 上获取收件箱中的短信内容。

　　（1）每个帐户对应的是一个MsgStore。每个MsgStore可包含一组文件夹。

　　（2）提供EntryID，用 OpenEntry 方法打开MAPI对象。

　　（3）MAPI容器使用 GetContentTable 获取容器内内容的描述表。

　　（4）MAPI Table 使用SetColumns 设定要查询的字段。

　　（5）使用 MAPI 提供的函数释放相关查询信息分配的内存。

　　更多细节参考相关SDK 文档。

　　下面是代码。当打开收件箱以后，短信是按照时间升序排列的，因此使用 SeekRow 方法把游标游动到最后一行读出既是最近收到的短信。

Code_GetLastMessage

// 获取SMS的最近收到的短信，返回为“发件人：内容”的格式。
bool GetLastMessage(TCHAR * buffer, int bufferSize)
{
    HRESULT hr = S_OK;
    ICEMAPISession * pSession = NULL;
    IMsgStore * pMsgStore = NULL;
    IMAPIFolder * pFolder = NULL;
    IMessage * pMsg = NULL;

     // 和Table有关的MAPI对象
    IMAPITable * pTable = NULL;
    SRowSet * pRows = NULL;
    SPropValue * pSProps = NULL;
    ULONG ulObjType; // 对象类型
    ULONG cCount = 0 ;
     int remainLength, subjectLength; // 字符串长度
     bool result = false ;

     // 设置MsgStore表的要查询字段
    SizedSPropTagArray( 2 , Columns1) =
    {
         2 ,
        PR_ENTRYID, // Store的Entry ID
        PR_DISPLAY_NAME // Store的Display Name
    };
     // 设置收件箱内容表要查询的字段
    SizedSPropTagArray( 1 , Columns2) =
    {
         1 ,
        PR_ENTRYID   // 获取每个消息的EntryID
    };

    CoInitializeEx(NULL, COINIT_MULTITHREADED);
    hr = MAPIInitialize(NULL);
     if (FAILED(hr))
    {
        wcscpy_s(buffer, bufferSize, _T( " failed at: MAPIInitialize " ));
         goto TAG_CLEAR;
    }

    hr = MAPILogonEx( 0 , NULL, NULL, 0 , (LPMAPISESSION * ) & pSession);
     if (FAILED(hr))
    {
        wcscpy_s(buffer, bufferSize, _T( " failed at: MAPILogonEx " ));
         goto TAG_CLEAR;
    }
    hr = pSession -> GetMsgStoresTable( 0 , & pTable);
     if (FAILED(hr))
    {
        wcscpy_s(buffer, bufferSize, _T( " failed at: GetMsgStoresTable " ));
         goto TAG_CLEAR;
    }

    pTable -> SetColumns((LPSPropTagArray) & Columns1, 0 );

     while (SUCCEEDED(pTable -> QueryRows( 1 , 0 , & pRows)))
    {
         if (pRows == NULL || pRows -> cRows != 1 )
             break ;

         // 开始一条条记录查询,
         // pRows->aRow[0].lpProps[0]代表了第一个查询属性，即Entry ID,
         // pRows->aRow[0].lpProps[1]则表示Display Name。
         if (_tcsicmp(pRows -> aRow[ 0 ].lpProps[ 1 ].Value.lpszW, _T( " SMS " )) == 0 )
        {
             // 如果是SMS，则获取Store对象
            pSession -> OpenEntry(
                pRows -> aRow[ 0 ].lpProps[ 0 ].Value.bin.cb, (LPENTRYID)pRows -> aRow[ 0 ].lpProps[ 0 ].Value.bin.lpb,
                NULL, MAPI_BEST_ACCESS,     & ulObjType,(LPUNKNOWN * ) & pMsgStore
                );
             break ;
        }
        FreeProws(pRows);
        pRows = NULL;
    }
     if (pRows != NULL)
    {
        FreeProws(pRows);
    }
     if (pTable != NULL)
    {
        pTable -> Release();
    }

     if (pMsgStore == NULL)
    {
        wcscpy_s(buffer, bufferSize, _T( " Cannot Open MsgStore of SMS. " ));
         goto TAG_CLEAR;
    }

     // 查询“收件箱”的ENTRYID
    ULONG STags[] = { 1 ,    PR_CE_IPM_INBOX_ENTRYID };
    hr = pMsgStore -> GetProps((SPropTagArray * ) & STags, 0 , & cCount, & pSProps);
     if (FAILED(hr))
    {
        wcscpy_s(buffer, bufferSize, _T( " Cannot Get Inbox's EntryID. " ));

　　    if(pSProps != NULL) MAPIFreeBuffer(pSProps);
         goto TAG_CLEAR;
    }

     // 打开收件箱文件夹
    hr = pMsgStore -> OpenEntry(pSProps[ 0 ].Value.bin.cb, (LPENTRYID)pSProps[ 0 ].Value.bin.lpb,NULL, 0 , & ulObjType, (IUnknown ** ) & pFolder);

if(pSProps != NULL)
MAPIFreeBuffer(pSProps);

     if (FAILED(hr))
    {
        wcscpy_s(buffer, bufferSize, _T( " Cannot Open Folder Of Inbox. " ));
         goto TAG_CLEAR;
    }

     // 获取收件箱的内容表。
    pFolder -> GetContentsTable( 0 , & pTable);

     // 尝试移动到最后一行（最近收到的短信）
    ULONG rowCount;
    hr = pTable -> GetRowCount( 0 , & rowCount);
     if (FAILED(hr) || rowCount <= 0 )
    {
        pTable -> Release();
        pTable = NULL;
        wcscpy_s(buffer, bufferSize, _T( " 收件箱：没有新的消息。 " ));
         goto TAG_CLEAR;
    }
    hr = pTable -> SeekRow(BOOKMARK_BEGINNING, rowCount - 1 , NULL);
    hr = pTable -> SetColumns((LPSPropTagArray) & Columns2, 0 );

     // 要查询的消息属性：发件人，主题（短信内容）
    ULONG pMsgPropTags[] = { 2 , PR_SENDER_EMAIL_ADDRESS, PR_SUBJECT };

     while (SUCCEEDED(pTable -> QueryRows( 1 , 0 , & pRows)))
    {
         // 通过OpenEntry获取IMessage对象
        pFolder -> OpenEntry(
            pRows -> aRow[ 0 ].lpProps[ 0 ].Value.bin.cb,
            (LPENTRYID)pRows -> aRow[ 0 ].lpProps[ 0 ].Value.bin.lpb, // Message's EntryID
            NULL,
            MAPI_BEST_ACCESS,
             & ulObjType,
            (LPUNKNOWN * ) & pMsg
            );
         // 这里拿到每个IMessage对象就代表了Folder里面的每一条Message,可以通过对它的操作来获取想要的信息。
        hr = pMsg -> GetProps((SPropTagArray * ) & pMsgPropTags, MAPI_UNICODE, & cCount, & pSProps);
         if (SUCCEEDED(hr))
        {
             if (pSProps[ 0 ].ulPropTag == PR_SENDER_EMAIL_ADDRESS)
            {
                wcscpy_s(buffer, bufferSize, pSProps[ 0 ].Value.lpszW);
                wcscat_s(buffer, bufferSize, _T( " : " ));
            }
             else
            {
                buffer[ 0 ] = ' \0 ' ;
            }

             if (pSProps[ 1 ].ulPropTag == PR_SUBJECT)
            {
                remainLength   = bufferSize - wcslen(buffer) - 1 ;
                subjectLength = wcslen(pSProps[ 1 ].Value.lpszW);
                 if (remainLength >= subjectLength)
                    wcscat_s(buffer, bufferSize, pSProps[ 1 ].Value.lpszW);
                 else
                {
                     // 截断字符串，并用三个点表示省略。
                    wcsncpy_s(buffer + wcslen(buffer), bufferSize, pSProps[ 1 ].Value.lpszW, remainLength - 3 );
                    wcscat_s(buffer, bufferSize, _T( " ... " ));
                }
            }
            result = true ;
        }
         else
        {
            wcscpy_s(buffer, bufferSize, _T( " Cannot Get Message. " ));
        }
         if (pSProps != NULL)
            MAPIFreeBuffer(pSProps);

         // 仅仅读取一条Message
         break ;
    }

     if (pRows != NULL)
    {
        FreeProws(pRows);
        pRows = NULL;
    }
     if (pTable != NULL)
    {
        pTable -> Release();
        pTable = NULL;
    }

TAG_CLEAR:

     if (pMsg != NULL)
        pMsg -> Release();

     if (pFolder != NULL)
        pFolder -> Release();

     if (pMsgStore != NULL)
        pMsgStore -> Release();

     if (pSession != NULL)
    {
        pSession -> Logoff( 0 , 0 , 0 );
        pSession -> Release();
    }
    MAPIUninitialize();
    CoUninitialize();
     return result;
}

　　本段代码已运用于 LedScreen插件V2.0 中：　　
　　

　　【例子2】：在ActiveX控件中调用页面上的 JavaScrpt 方法。

　　（1）IE调用ActiveX控件的方法，本质上是通过控件的 IDispatch 接口调用的，该技术也就是自动化技术。该技术绑定时间比自定义接口最晚，因此效率不如通过自定义接口调用，但是也最灵活。当我们在ActiveX 控件中调用页面的脚本时，我们同样通过脚本对象的 IDispatch 接口调用。

　　（2）假设 ActiveX 控件事先知道页面上的方法的参数列表，（相当于我们已知一个C#委托或者C++函数指针定义），如果不这样假定，则实在意义不大。

　　 (3) 我们在控件接口中添加一个方法，称为InvokeJS。在这个方法里我们试图调用页面上的一个指定名称的javascript方法。并且我们给这个方法一个字符串参数，内容是”hello world“。代码如下：

code_InvokeJS

// 调用JS方法（无参数）
STDMETHODIMP CMyControl::InvokeJS(BSTR funName)
{
     if (m_document == NULL)
         return S_OK;

    CComPtr < IHTMLDocument2 > pHtmlDoc;
    CComPtr < IDispatch > pScript; // CComPtr：会自动调用Release();

    HRESULT hr;
    CComBSTR bstrMember;
    DISPID dispid; // DISPID即LONG（int32），接口函数的数字序号。

    bstrMember.AssignBSTR(funName);
    hr = this -> m_document -> QueryInterface(IID_IHTMLDocument2, ( void ** ) & pHtmlDoc);
    hr = pHtmlDoc -> get_Script( & pScript);
    hr = pScript -> GetIDsOfNames(IID_NULL, & bstrMember, 1 , LOCALE_SYSTEM_DEFAULT, & dispid);

     // 调用脚本对象的Invoke方法执行脚本函数：
    DISPPARAMS dispparams;
    memset( & dispparams, 0 , sizeof dispparams);
    dispparams.cArgs = 1 ;
    dispparams.rgvarg = new VARIANT[dispparams.cArgs];

     for ( int i = 0 ; i < dispparams.cArgs; i ++ )
    {
        CComBSTR bstr = " hello world " ; // back reading
        bstr.CopyTo( & dispparams.rgvarg[i].bstrVal);
        dispparams.rgvarg[i].vt = VT_BSTR;
    }
    dispparams.cNamedArgs = 0 ;

    EXCEPINFO excepInfo;
    memset( & excepInfo, 0 , sizeof excepInfo);
    CComVariant vaResult;

    UINT nArgErr = (UINT) - 1 ;   // initialize to invalid arg
    hr = pScript -> Invoke(dispid, IID_NULL, 0 , DISPATCH_METHOD, & dispparams, & vaResult, & excepInfo, & nArgErr);

     return S_OK;
}

　　浏览器对象实际上我们是在控件的 SetClientSite 方法中获取的，该方法在创建控件时由容器调用，以给ActiveX控件一个时机去获取一些容器信息。则在MSDN文档中有专门介绍。控件的SetClientSite代码如下：

code_setClientSite

// 以下是控件的两个成员变量：
private :
    IWebBrowser2 * m_browser; // 浏览器对象
    IDispatch * m_document; // 文档对象

STDMETHODIMP CMyControl::SetClientSite(IOleClientSite * pClientSite)
{
    HRESULT hr = S_OK;
    IServiceProvider * isp, * isp2 = NULL;
     // BSTR url;

     if ( ! pClientSite)
    {
        COMRELEASE(m_browser);
    }
     else
    {
        hr = pClientSite -> QueryInterface(IID_IServiceProvider, reinterpret_cast < void **> ( & isp));
         if (FAILED(hr))
        {
            hr = S_OK;
             goto cleanup;
        }
        hr = isp -> QueryService(SID_STopLevelBrowser, IID_IServiceProvider, reinterpret_cast < void **> ( & isp2));
         if (FAILED(hr))
        {
            hr = S_OK;
             goto cleanup;
        }
        hr = isp2 -> QueryService(SID_SWebBrowserApp, IID_IWebBrowser2, reinterpret_cast < void **> ( & m_browser));
         if (FAILED(hr))
        {
            hr = S_OK;
             goto cleanup;
        }

         // 获取文档对象
        hr = m_browser -> get_Document( & m_document);
         if (FAILED(hr))
        {
            m_document = NULL;
        }
         // m_browser->get_LocationURL(&url);
         // MessageBox((LPCTSTR)url, _T(""), MB_OK);
cleanup:
         // Free resources.
        COMRELEASE(isp);
        COMRELEASE(isp2);
         return hr;
    }

     return S_OK;
}

　　（4）假设在页面上具有这样一个JS方法：当我们点击按钮时，页面首先通过IDispatch接口找到控件的InvokeJS方法，然后在控件中又通过IDispatch接口找到脚本的AlertMessage方法，弹出一个MessageBox。

code_HTML

< HTML >
< HEAD >
< TITLE > 对象测试页 </ TITLE >
</ HEAD >
< BODY >
< script type ="text/javascript" >
function AlertMessage(info)
{
alert(info);
}
</ script >
< OBJECT ID ="MyControl" CLASSID ="CLSID:......" ></ OBJECT >
< button onclick ="MyControl.InvokeJS('AlertMessage');" > InvokeJavaScript </ button >
</ BODY >
</ HTML >

　　【例子3】：通过 ITaskBar 对象隐藏或显示任务栏按钮。

Code_ShowInTaskBar

void ShowInTaskbarList(HWND hWnd, BOOL bShow)
{
    HRESULT hr;
    ITaskbarList * pTaskbarList;

    CoInitialize(NULL);
    hr = CoCreateInstance(CLSID_TaskbarList, NULL, CLSCTX_INPROC_SERVER,
            IID_ITaskbarList, ( void ** ) & pTaskbarList);

     // ==============  HrInit();==================
     // Initializes the taskbar list object. This method must be called before any other
     // ITaskbarList methods can be called.
    pTaskbarList -> HrInit();

     if (bShow)
    {
        pTaskbarList -> AddTab(hWnd);
    }
     else
    {
        pTaskbarList -> DeleteTab(hWnd);
    }
    pTaskbarList -> Release();

    CoUninitialize();
}

　　参考内容：

　　《Mapi实例》：http://bingqingwu5799.blog.163.com/blog/static/338365512009320111114912/

　　MSDN & Windows Mobile 6 SDK Documents；

　　CSDN 关于 ActiveX 调用页面脚本的文章。（原连接未记录）

【COM范例】WM上获取短信内容，AcitiveX控件调用页面JS方法

热门文章

最新文章

相关课程

相关电子书

相关实验场景