CEMAPI操作信箱中的短信息(上)

三．操作信箱中的短信息

1.       Windows mobile中短消息的组成

用过的Windows Mobile平台设备的朋友在第一次发送的短信的时候或多或少都会有些困惑，尤其是使用Windows Mobile 2003以前版本的朋友，发短信的UI上不但有填写目的号码和正文的地方，还有填写主题，CC甚至BCC的位置，搞得用户不知如何是好。为什么会有这些内容前面实际上已经提到过了。WM系统中邮件和短消息属于一个系统，微软为了开发方便将二者使用了相同的架构和接口，因此才会有短消息中存在CC和BCC这样的事情出现。虽然从WM5.0以后的版本开始，主题，CC，BCC等东西已经不见了，但是为了后面方便阐述解析原始短信息部分内容，这里简单的说一下短信的结构组成。

CC，BCC这些内容是发送短信中不需要的，填写了也没有什么效果。但是主题（subject）如果填写了是会对短信内容产生影响的。MSDN上介绍，如果发送短信的时候在主题和正文（Body）中都填写了内容，那么发送时，系统会在主题的内容后增加一个换行符，然后在把正文添加到后面作为短信真正的正文发送出去。注意WM中的换行符是\n而不是\r\n。除了主题和正文以外，一条短息还包括发送时间，接收时间，发送方号码，接受方号码等属性组成。在某一条具体信息之中这些属性不一定同时存在，对于不同具体信箱(Folder)中的短信息，拥有不同的属性。例如：收件箱中的短信，只有正文、发送方号码、发送时间这几个属性。

2.       IMessage接口

          前面对短信的结构做了一个简要的了解，现在要介绍一个与短信相关的非常重要的接口，IMessage接口。该接口直接继承自IMAPIProp，有IMAPIProp间接继承自IUnknow接口，同样属于COM对象。接口中封装了与短信相关的基本操作，常用的方法，例如Get/SetProps、SubMessage、SaveChange等方法是值得大家去特别注意的，这些方法的用法，后面会提到。

3.       SizedSPropTagArray宏

       上一部分中我们已经介绍过SizedSPropTagArray宏以及用它动态生成结构体类型的方法，这里再强调一下，这个宏在cemapi中非常重要，希望大家能够关注。关于这个宏的使用方法，请参见上一部分的内容。

4.       从具体信箱中获取一条原始短消息

          上一部分中已经详细的讨论了如何建立与短信邮件系统的会话（Session），如何获取短信仓库(MsgStore)以及如何与具体的信箱（Folder）进行连接。我们先来简单回顾一下，首先利用MAPILogonEx函数建立与短信邮件系统的会话，然后利用IMAPISession接口的对象获取所有消息（邮件）仓库(MsgStore)，遍历这些仓库，根据PR_DISPLAY_NAME属性的值获取短信所对应的短信仓库对象。然后根据具体信箱对应的参数获取指向具体信箱的对象(Folder)。

        有了具体的信箱以后，下面需要做的就是要从该信箱中获取一条原始短消息了，原始短消息由Imessage接口对应的对象表示。前面说过，Cemapi中无论是短信（邮件）仓库MsgStore，还是具体信箱(Folder)均是由表格的形式表示的，Folder中的短信自然也不例外。我们可以通过GetContentsTable方法来获取信息对应的表格对象IMAPITable。如果大家忘记了，可以返回上一部分再看一下。GetContentsTable方法声明如下：

                   HRESULT IMAPIFolder::GetContentsTable(ULONG,IMAPITable **);

      方法的返回值用于判断方法是否执行正确。参数列表：

ULONG：很抱歉，这个参数我没有看到过相关的介绍，在我们的应用中赋值为0是可以正常工作的。

IMAPITable **：用于返回短信列表对应的表结构。

            

我认为Cemapi中有一个原则（你可以不这么认为），只要出现了IMAPITable接口的对象，就需要采用SizePropTagArray这个宏来声明一个动态结构体，并且调用SetColumns告诉IMAPITable接口对象，列表中的行记录的组织结构。现在我们需要获取行记录中的ENTRYID，然后用这个ENTRYID去Folder中获取对应的短信息对象。

        SizedSPropTagArray(1, Columns) =    //动态生成结构体对象，只获取Entry ID属性

        {

            1,

            PR_ENTRYID  

};

还记得这么声明的意义吗？我们声明了一个动态结构体变量Columns，该结构体中的ULONG值为1（表示数组元素数量），ULONG数组共一个元素，名为PR_ENTRYID。有了这个结构体以后，采用SetColumns方法就可以对表格中行记录结构进行设置了。源代码如下：

              IMAPITable  *m_pTable = NULL;

m_pFolder->GetContentsTable(0, &m_pTable);      //获取该Box下的短信行记录列表

hr = m_pTable->SetColumns((LPSPropTagArray)&Columns, 0);    //设置列格式

行记录结构设置完毕以后，与获取MsgStore对象类似，使用QueryRows方法就可以获取该表中所有的行记录了。获取每一行的ENTRYID属性，然后使用IMAPIFolder中的OpenEntry方法（很熟悉吧，没错，就是与获取MsgStore时ImsgStore中的同名方法相同）来获取EntryId对应的短消息了。

获取原始短消息的代码如下：

        LPMAPITABLE  m_pTable = NULL;

        LPSRowSet m_pRows = NULL;

        HRESULT hr;

        

        SizedSPropTagArray(1, Columns) =    //动态生成结构体对象，只获取Entry ID属性

        {

            1,

            PR_ENTRYID  

        };



        m_pFolder->GetContentsTable(0, &m_pTable);      //获取该Box下的内容列表

        hr = m_pTable->SetColumns((LPSPropTagArray)&Columns, 0);    //设置列记录结构



        if(FAILED(hr))

        {

            //异常处理

        }



        ULONG ulRowCount=0;

        ULONG i=0;



        m_pTable->GetRowCount(0,&ulRowCount);           //获取列表中行记录总数

        

        while(!FAILED(m_pTable->QueryRows(1, 0, &m_pRows)))

        {

            if(i==ulRowCount) break;         //如果已经遍历完毕

            else i++;



            IMessage *m_pMsg = NULL;

            ULONG ulMesageType;

            //通过OpenEntry获取IMessage对象

            hr=m_pFolder->OpenEntry( m_pRows->aRow[0].lpProps[0].Value.bin.cb,

             (LPENTRYID)m_pRows->aRow[0].lpProps[0].Value.bin.lpb,

             NULL,

             MAPI_BEST_ACCESS,

             &ulMesageType,

             (LPUNKNOWN*)&m_pMsg);



            if(!FAILED(hr) && NULL!=m_pMsg)     //取到了消息

            {

                //取到了原始消息

            }



                if(m_pRows)

                {      

                    FreemProws(m_pRows);        //释放行

                    m_pRows=NULL;

                }

        }



        if(m_pTable)

        {

            m_pTable->Release();        //释放表结构

            m_pTable=NULL;

}

    5.释放IMessage对象.

        使用IMessage::Release()方法，可以安全的释放该对象。代码如下：

m_pMsg->Release();