WINCE MAPI实例讲解 --- 如何获取Inbox里的所有消息

作者：太阳下的泪

转自：http://blog.sina.com.cn/s/blog_5be1061c0100b7mb.html

转载别人的:

 

第一次写这玩意，感觉挺别扭，不过想想以前遇到问题的时候，也从网络上得到过很多帮助，同时在CSDN，也看到有些网友在问关于MAPI的问题，自己虽然水平不怎么样，写东西也烂，但是觉的有必要将自己这几年积累的东西同大家分享一下，希望对大家能有些帮助。我的写作能力不怎么样，这点接下来看我的文章就会有感觉，呵呵，所以我会尽量用代码来表达我的意思，对于一些理论知识，我了解比较肤浅，有错误的地方，希望大家能够指正，谢谢先！ 
     对于MAPI的意义，用处我就不多说了，大家可以去MSDN上找一下，我的英语烂，免的误导群众。接下来的例子为了减少篇幅，我将略去所有错误处理，但是在平时的使用过程中，希望使用者能加上详细的错误处理，这能使我们的程序更加健壮。
     来看第一个例子，如何获取tmail（就是我们熟称的收件箱程序）下各个Message Box下的消息。
     第一步：初始化MAPI：
  //session变量，在停止使用MAPI前，请不要释放它
  IMAPISession* m_pSession =NULL;   

  //COM初始化
  CoInitializeEx(NULL,COINIT_MULTITHREADED);  
  MAPIInitialize(NULL);
  MAPILogonEx(NULL, NULL, NULL,NULL,&m_pSession);
  

    退出MAPI
 if(m_pSession)
  {
  m_pSession->Logoff(0,0, 0); 
   m_pSession->Release();
  m_pSession = NULL;
 }
  MAPIUninitialize();
  CoUninitialize();

     第二步：获取message store,对于messagestore,我认为它是管理message和folder的一个集合，它与收件箱下的各个帐户想对应，每个帐户对应有一个store,我们可以通过session来遍历所有messagestore,每个store都会有一个DISPLAYNAME,通过它我们可以获得指定的store,下面演示如何获取SMS的Store:
 //IMAPITABLE，通过它我们可以访问数据，比如拿Store,拿Folder,拿Message等，方法都类似，下面会有介绍
  LPMAPITABLE pTable = NULL;
  ULONG lCount  = 0;
  HRESULThr  = 0;
  LPSRowSetpRows  = NULL;
  IMsgStore*pMsgStore = NULL;
  //希望获取多少属性,这里我们只需要获得两个属性
  ULONG ulNumCols = 2;
  //通过下面的定义，我们告诉系统，我们需要获取以下两个属性，一个是EntryID，通过它我们可以获取Store对象，一个是Display Name,我们用它来比较是不是我们需要的Store
  SizedSPropTagArray(ulNumCols ,Columns) =
  { 
   ulNumCols, 
   PR_ENTRYID, //Store的EntryID
   PR_DISPLAY_NAME //Store的DisplayName
  };

  pSession->GetMsgStoresTable(MAPI_UNICODE, &pTable);
  pTable->SetColumns((LPSPropTagArray)&Columns,0);

  while(SUCCEEDED(pTable->QueryRows(1,0, &pRows)))
  {

   if(NULL == pRows ||pRows->cRows != 1)

       {

           break;

       }
   //开始一条条记录查询,pRows->aRow[0].lpProps[0]代表了第一个查询属性，即EntryID,pRows->aRow[0].lpProps[1]则表示Display Name。
   if(_tcsicmp(pRows->aRow[0].lpProps[1].Value.lpszW,_T("SMS")) == 0)
   {
    ULONGulMesageType;
    //如果是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,
      &ulMesageType,
      (LPUNKNOWN*)&pMsgStore);
    break;
   }
   
   FreeProws(pRows);
   pRows =NULL;
  }
  if(pRows)
  {
   FreeProws(pRows);
   pRows =NULL;
  }

 到此，就拿到了SMS的MessageStore,累死了，休息一下，接下来让我们继续来获取Folder。在这里我先提醒一下，前面获取的IMsgStore和后面要讲的IMAPIFolder等对象，在不使用时候需要Release(),千万别忘记。

第三步：获取Folder。我们以Drafts为例。
 LPSPropValue rgprops  =NULL;
 ULONGulValues   = 0;
 //设置我们想拿哪个Folder,详细可以查阅MSDN关于ImsgStore的介绍，在这里我将常用的几个Folder的属性值列一下：
 //PR_CE_IPM_DRAFTS_ENTRYID    drafts,草稿箱
 //PR_CE_IPM_INBOX_ENTRYID Inbox,收件箱
 //PR_IPM_OUTBOX_ENTRYID Outbox,发件箱
 //PR_IPM_SENTMAIL_ENTRYID Sentbox,这个不知道叫什么好，寄件箱？就是已经发送的消息放的box.
 //PR_IPM_WASTEBASKET_ENTRYID 垃圾箱
 ULONGrgTags[]   = { 1,PR_CE_IPM_DRAFTS_ENTRYID};

 // 获取Folder的EntryID,然后通过OpenEntry获得对象
 pMsgStore->GetProps((LPSPropTagArray)rgTags, MAPI_UNICODE, &ulValues,&rgprops);
 pMsgStore->OpenEntry(rgprops[0].Value.bin.cb,(LPENTRYID)rgprops[0].Value.bin.lpb, NULL, MAPI_MODIFY, NULL,(LPUNKNOWN*)pFolder );
 MAPIFreeBuffer(rgprops);
 这样，我就拿到了需要的Folder,接下来还剩下最后一件事情，就是遍历message,其实它的过程和拿Store的过程十分相似。

第四步：获取message。
 LPMAPITABLE  pTable =NULL;
 LPSRowSet pRows = NULL;
 ULONG  ulNumCols = 1;
 //指定我们需要获取Entry ID属性
 SizedSPropTagArray(ulNumCols, Columns) =
 {
  ulNumCols,
  PR_ENTRYID 
 };

 pFolder->GetContentsTable(0,&pTable);
 hr =pTable->SetColumns((LPSPropTagArray)&Columns,0);
 //从这些代码可以看出，和获取MessageStore的方法很相似，只不过一个是从Session对象里拿，而另一个是从Folder里面拿而已。

 while(SUCCEEDED(pTable->QueryRows(1,0, &pRows)))
 {
  LPMESSAGE pMsg = NULL;
  ULONG ulMesageType;
  //通过OpenEntry获取IMessage对象
  pFolder->OpenEntry(pRows->aRow[0].lpProps[0].Value.bin.cb,
    (LPENTRYID)pRows->aRow[0].lpProps[0].Value.bin.lpb,
    NULL,
    MAPI_BEST_ACCESS,
    &ulMesageType,
    (LPUNKNOWN*)&pMsg);
 //这里拿到每个IMessage对象就代表了Folder里面的每一条Message,可以通过对它的操作来获取想要的信息。
  ......
  //不需要时记的释放
  pMsg->Release();
  FreeProws(pRows);
  pRows = NULL;
 }
 if(pRows)
 {
  FreeProws(pRows);
 }
 if(pTable)
 {
  pTable->Release();
 }

终于完工了，第一次写，不知道讲的清楚不，如有不对的地方，欢迎大家指正。