home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / dbmsg / mapi / command.ext / cmdext.cpp next >
Encoding:
C/C++ Source or Header  |  1996-04-11  |  24.6 KB  |  916 lines
  1. ///////////////////////////////////////////////////////////////////////////////
  2. //
  3. //  File Name
  4. //      CMDEXT.CPP 
  5. //
  6. //  Description
  7. //      Implementation of interface objects
  8. //
  9. //      IExchExt interface methods:
  10. //          MyExchExt::QueryInterface()
  11. //          MyExchExt::AddRef()
  12. //          MyExchExt::Release()
  13. //
  14. //          MyExchExt::Install()
  15. //
  16. //      IExchExtCommands interface methods:
  17. //          MyExchExtCommands::QueryInterface()
  18. //          MyExchExtCommands::AddRef()
  19. //          MyExchExtCommands::Release()
  20. //
  21. //          MyExchExtCommands::InstallCommands()
  22. //          MyExchExtCommands::DoCommand()
  23. //          MyExchExtCommands::InitMenu()
  24. //          MyExchExtCommands::Help()
  25. //          MyExchExtCommands::QueryHelpText()
  26. //          MyExchExtCommands::QueryButtonInfo()
  27. //          MyExchExtCommands::ResetToolbar()
  28. //
  29. //          MyExchExtCommands::SetContext()
  30. //          MyExchExtCommands::GetCmdID()
  31. //
  32. //      IExchExtUserEvents interface methods:
  33. //          MyExchExtUserEvents::QueryInterface()
  34. //          MyExchExtUserEvents::AddRef()
  35. //          MyExchExtUserEvents::Release()
  36. //
  37. //          MyExchExtUserEvents::OnSelectionChange()
  38. //          MyExchExtUserEvents::OnObjectChange()
  39. //
  40. //          MyExchExtUserEvents::SetContext()
  41. //          MyExchExtUserEvents::SetIExchExt()
  42. //
  43. //  Author
  44. //      Gary Peluso
  45. //
  46. //  Revision: 1.00
  47. //
  48. // Written for Microsoft Windows Developer Support
  49. // Copyright (c) 1992-1995 Microsoft Corporation. All rights reserved.
  50. //
  51. #define INITGUID
  52. #define USES_IID_IExchExt
  53. #define USES_IID_IExchExtAdvancedCriteria
  54. #define USES_IID_IExchExtAttachedFileEvents
  55. #define USES_IID_IExchExtCommands
  56. #define USES_IID_IExchExtMessageEvents
  57. #define USES_IID_IExchExtPropertySheets
  58. #define USES_IID_IExchExtSessionEvents
  59. #define USES_IID_IExchExtUserEvents
  60. #define USES_IID_IMAPIFolder
  61.  
  62. #include "CMDEXT.H"
  63.  
  64. ///////////////////////////////////////////////////////////////////////////////
  65. // data
  66. static HINSTANCE ghInstDLL = NULL;  // instance handle of DLL
  67.  
  68. ///////////////////////////////////////////////////////////////////////////////
  69. //    FUNCTION: DLLMain()
  70. //
  71. //    Purpose
  72. //    Do initilization processesing
  73. //
  74. //    Return Value
  75. //    TRUE - DLL successfully loads and LoadLibrary will succeed.
  76. //    FALSE - will cause an Exchange error message saying it cannot locate
  77. //            the extension DLL.
  78. //
  79. //    Comments
  80. //    We only need to get a copy of the DLL's HINSTANCE
  81. //
  82. BOOL WINAPI DllMain(
  83.     HINSTANCE  hinstDLL,
  84.     DWORD  fdwReason,   
  85.     LPVOID  lpvReserved) 
  86. {
  87.  if (DLL_PROCESS_ATTACH == fdwReason)
  88.  {
  89.     ghInstDLL = hinstDLL;
  90.  }
  91.  return TRUE;
  92. }
  93.  
  94. ///////////////////////////////////////////////////////////////////////////////
  95. //    FUNCTION: ExchEntryPoint
  96. //
  97. //    Parameters - none
  98. //
  99. //    Purpose
  100. //    The entry point which Exchange calls.  
  101. //
  102. //    Return Value
  103. //    Pointer to Exchange Extension Object
  104. //
  105. //    Comments
  106. //    This is called for each context entry.  Create a new MyExchExt object
  107. //    every time so each context will get its own MyExchExt interface.
  108. //
  109. LPEXCHEXT CALLBACK ExchEntryPoint(void)
  110. {
  111.     return new MyExchExt;
  112. }
  113.  
  114.  
  115. ///////////////////////////////////////////////////////////////////////////////
  116. //    MyExchExt::MyExchExt()
  117. //
  118. //    Parameters - none
  119. //
  120. //    Purpose
  121. //    Constructor. Initialize members and create supporting interface objects
  122. //
  123. //    Comments
  124. //    Each context of Exchange gets its own set of interface objects.
  125. //    Furthermore, interface objects per context are kept track of by Exchange
  126. //    and the interface methods are called in the proper context.
  127. //    
  128. MyExchExt::MyExchExt () 
  129. { 
  130.   m_cRef = 1; 
  131.   m_context = 0;
  132.   
  133.   m_pExchExtCommands = new MyExchExtCommands;
  134.   m_pExchExtUserEvents = new MyExchExtUserEvents;
  135.  
  136.   // in MyExchExtUserEvents methods I need a reference to MyExchExt
  137.   m_pExchExtUserEvents->SetIExchExt(this);
  138.  
  139. }
  140.  
  141.  
  142. ///////////////////////////////////////////////////////////////////////////////
  143. //  IExchExt virtual member functions implementation
  144. //
  145.  
  146. ///////////////////////////////////////////////////////////////////////////////
  147. //    MyExchExt::QueryInterface()
  148. //
  149. //    Parameters
  150. //    riid   -- Interface ID.
  151. //    ppvObj -- address of interface object pointer.
  152. //
  153. //    Purpose
  154. //    Called by Exchage to request for interfaces
  155. //
  156. //    Return Value
  157. //    S_OK  -- interface is supported and returned in ppvObj pointer
  158. //    E_NOINTERFACE -- interface is not supported and ppvObj is NULL
  159. //
  160. //    Comments
  161. //    Exchange client calls QueryInterface for each object.  Only
  162. //    Need to support objects that apply to the extension.  QueryInterface
  163. //    is called onces for each IID for each context.  We support two
  164. //    contexts in this example so QueryInterface is called twice for
  165. //    each IID.
  166. //    
  167. STDMETHODIMP MyExchExt::QueryInterface(REFIID riid, LPVOID * ppvObj)
  168. {
  169.     HRESULT hr = S_OK;
  170.  
  171.     *ppvObj = NULL;
  172.  
  173.     if ( (IID_IUnknown == riid) || (IID_IExchExt == riid) )
  174.     {
  175.         *ppvObj = (LPUNKNOWN)this;
  176.     }
  177.     else if ( IID_IExchExtCommands == riid)
  178.     {
  179.         *ppvObj = (LPUNKNOWN)m_pExchExtCommands;
  180.         m_pExchExtCommands->SetContext(m_context);
  181.     }
  182.     else if ( IID_IExchExtUserEvents == riid)
  183.     {
  184.         *ppvObj = (LPUNKNOWN)m_pExchExtUserEvents;
  185.         m_pExchExtUserEvents->SetContext(m_context);
  186.     }
  187.     else
  188.         hr = E_NOINTERFACE;
  189.  
  190.     if (NULL != *ppvObj)
  191.         ((LPUNKNOWN)*ppvObj)->AddRef();
  192.  
  193.     return hr;
  194. }
  195.  
  196.  
  197.  
  198. ///////////////////////////////////////////////////////////////////////////////
  199. //    MyExchExt::Install()
  200. //
  201. //    Parameters
  202. //    peecb     -- pointer to Exchange Extension callback function
  203. //    eecontext -- context code at time of being called.
  204. //    ulFlags   -- flag to say if install is for modal or not
  205. //
  206. //    Purpose
  207. //    Called once for each new contexted that is entered.  Proper version 
  208. //    number is checked here.  
  209. //
  210. //    Return Value
  211. //    S_OK -- object supported in the requested context
  212. //    S_FALSE -- object is not supported in teh requested context
  213. //
  214. //    Comments
  215. //
  216.  STDMETHODIMP MyExchExt::Install (LPEXCHEXTCALLBACK pmecb, 
  217.                          ULONG mecontext, ULONG ulFlags)
  218. {
  219.     ULONG ulBuildVersion;
  220.     HRESULT hr;
  221.  
  222.     m_context = mecontext;
  223.  
  224.     // make sure this is the right version 
  225.     pmecb->GetVersion(&ulBuildVersion, EECBGV_GETBUILDVERSION);
  226.     if (EECBGV_BUILDVERSION_MAJOR != (ulBuildVersion & EECBGV_BUILDVERSION_MAJOR_MASK))
  227.         return S_FALSE;
  228.  
  229.     switch (mecontext)
  230.     {
  231.         case EECONTEXT_VIEWER:
  232.         case EECONTEXT_SEARCHVIEWER:
  233.             hr = S_OK;
  234.             break;
  235.         default:
  236.             hr = S_FALSE;
  237.             break;
  238.     }
  239.     return hr;
  240. }
  241.  
  242. ///////////////////////////////////////////////////////////////////////////////
  243. //  IExchExtCommands virtual member functions implementation
  244. //
  245.  
  246. ///////////////////////////////////////////////////////////////////////////////
  247. //    MyExchExtCommands::QueryInterface()
  248. //
  249. //    Parameters
  250. //    riid   -- Interface ID.
  251. //    ppvObj -- address of interface object pointer.
  252. //
  253. //    Purpose
  254. //    Exchange Client does not call IExchExtCommands::QueryInterface().  
  255. //    So return nothing.
  256. //
  257. //    Return Value - none
  258. //
  259.  
  260. STDMETHODIMP MyExchExtCommands::QueryInterface(REFIID riid, LPVOID FAR * ppvObj)          
  261. {
  262.     *ppvObj = NULL;
  263.     if ( (riid == IID_IExchExtCommands) || (riid == IID_IUnknown) )
  264.     {
  265.         *ppvObj = (LPVOID)this;
  266.         // Increase usage count of this object
  267.         AddRef();
  268.         return S_OK;
  269.     }
  270.     return E_NOINTERFACE;
  271. }
  272.  
  273. ///////////////////////////////////////////////////////////////////////////////
  274. //    MyExchExtCommands::InstallCommands()
  275. //
  276. //    Parameters
  277. //    pmecb  -- Exchange Callback Interface
  278. //    hWnd   -- window handle to main window of context
  279. //    hMenu  -- menu handle to main menu of context
  280. //    lptbeArray -- array of toolbar button entries
  281. //    ctbe   -- count of button entries in array
  282. //    ulFlags -- reserved
  283. //
  284. //    Purpose
  285. //    This function is called when commands are installed for each context
  286. //    the extension services.
  287. //
  288. //    Return Value
  289. //    S_FALSE means the commands have been handled.
  290. //
  291. //    Comments
  292. //    The hWnd and hMenu are in context.  If the context is for the SENDNOTE 
  293. //    dialog, then the hWnd is the window handle to the dialog and the hMenu is
  294. //    the main menu of the dialog.
  295. //    
  296. //    Call ResetToolbar so that Exchange will show it's toolbar
  297. //
  298.  
  299.  
  300. STDMETHODIMP MyExchExtCommands::InstallCommands(LPEXCHEXTCALLBACK pmecb, 
  301.                             HWND hWnd, HMENU hMenu,
  302.                             UINT FAR * pcmdidBase, LPTBENTRY lptbeArray,
  303.                             UINT ctbe, ULONG ulFlags)
  304. {
  305.  HRESULT hr = S_FALSE;
  306.  HMENU hMenuTools;
  307.  
  308.  if ((EECONTEXT_SEARCHVIEWER == m_context) || (EECONTEXT_VIEWER == m_context))
  309.  {
  310.  
  311.  
  312.   // -------  install the new menu command, append to end of Tools menu. ----
  313.   m_hWnd = hWnd;
  314.  
  315.   pmecb->GetMenuPos(EECMDID_ToolsCustomizeToolbar, &hMenuTools, NULL, NULL, 0);
  316.  
  317.  
  318.   // add a menu separator
  319.    AppendMenu(hMenuTools, MF_SEPARATOR, 0, NULL);
  320.  
  321.   // add our extension command
  322.    AppendMenu(hMenuTools,
  323.          MF_BYPOSITION | MF_STRING, 
  324.          *pcmdidBase, 
  325.          "Folder Stats");
  326.  
  327.      m_cmdid = *pcmdidBase;
  328.  
  329.      (*pcmdidBase)++;
  330.  
  331.  }
  332.  
  333.  if (EECONTEXT_VIEWER == m_context)
  334.  {
  335.  
  336.   // --------------  install the new toolbar button --------------
  337.  
  338.   // walk through the toolbars and find the standard toolbar
  339.   
  340.   int tbindx;
  341.   HWND hwndToolbar = NULL;
  342.   for (tbindx = ctbe-1; (int) tbindx > -1; --tbindx)
  343.   {
  344.    if (EETBID_STANDARD == lptbeArray[tbindx].tbid)
  345.    {
  346.     hwndToolbar = lptbeArray[tbindx].hwnd;
  347.     m_itbb = lptbeArray[tbindx].itbbBase++;
  348.     break;
  349.    }
  350.   }
  351.  
  352.   // add out button's bitmap to the toolbar's set of buttons
  353.   if (hwndToolbar)
  354.   {
  355.    TBADDBITMAP tbab;
  356.  
  357.    tbab.hInst = ghInstDLL;
  358.    tbab.nID = IDB_EXTBTN;
  359.    m_itbm = SendMessage(hwndToolbar, TB_ADDBITMAP, 1, (LPARAM)&tbab);
  360.   }
  361.  
  362.  
  363.  }
  364.  
  365.  return hr;
  366.  
  367. }
  368.  
  369.  
  370. ///////////////////////////////////////////////////////////////////////////////
  371. //    MyExchExtCommands::DoCommand()
  372. //
  373. //    Parameters
  374. //    pmecb -- pointer to Exchange Callback Interface
  375. //
  376. //    Purpose
  377. //    This method is called by Exchange for each WM_COMMAND is sent to the
  378. //    window in context. 
  379. //
  380. //    Return Value
  381. //    S_OK if command is handled
  382. //    S_FALSE if command is not handled
  383. //
  384. //    Comments
  385. //    Use this function to either respond to the command item (menu or toolbar)
  386. //    added or modify an existing command in Exchange.  Return S_OK to let
  387. //    Exchange know the command was handled.  Return S_OK on commands you are
  388. //    taking over from Exchange.  Return S_FALSE to let Exchange know you want
  389. //    it to carry out its command, even if you modify its action.
  390. //
  391.                                                                                                           
  392. STDMETHODIMP MyExchExtCommands::DoCommand(LPEXCHEXTCALLBACK pmecb, UINT cmdid)
  393. {
  394.  static char szBuffer[200];
  395.  ULONG uNumSelected = 0;
  396.  ULONG ulSubFolders = 0;
  397.  ULONG ulReadMsgs = 0;
  398.  ULONG ulUnReadMsgs = 0;
  399.  LPMDB lpMDB = NULL;
  400.  LPMAPIFOLDER lpFolder = NULL;
  401.  LPMAPISESSION lpSession = NULL;
  402.  LPADRBOOK lpAddrBook = NULL;
  403.  ULONG cbeid;
  404.  LPENTRYID lpeid = NULL;
  405.  ULONG ulType;
  406.  char szMsgClass[50];
  407.  ULONG cbMsgClass;
  408. // ULONG ulMsgFlags; 
  409.  
  410.  HRESULT hr = S_FALSE;   // assume it is not our command
  411.  
  412.  if (m_cmdid != cmdid)
  413.     return hr;           // not our command
  414.  
  415.  if (m_context == EECONTEXT_VIEWER)
  416.  {
  417.  
  418.     cbMsgClass = 49;
  419.     szMsgClass[0] = '\0';
  420.  
  421.  
  422.     hr = pmecb->GetSession(&lpSession, &lpAddrBook);
  423.     if (FAILED(hr))
  424.     {
  425.         hr = S_OK;     // we still handled the command
  426.         goto error_return;
  427.     }
  428.  
  429.     hr = pmecb->GetSelectionItem(0, &cbeid, &lpeid, &ulType, NULL, 
  430.         0, NULL, 0);
  431.     if (FAILED(hr))
  432.     {
  433.         hr = S_OK;     // we still handled the command
  434.         goto error_return;
  435.     }
  436.  
  437.     if (ulType != MAPI_FOLDER)          // should never get this
  438.     {
  439.         hr = S_OK;     // we still handled the command
  440.         goto error_return;
  441.     }
  442.  
  443.  
  444.     hr = lpSession->OpenEntry(cbeid, lpeid, NULL, 0, &ulType, 
  445.                          (LPUNKNOWN FAR *)&lpFolder);
  446.     if (FAILED(hr))
  447.     {
  448.         hr = S_OK;     // we still handled the command
  449.         goto error_return;
  450.     }
  451.     
  452.  
  453.     if (NULL == lpFolder) 
  454.     {
  455.         hr = S_OK;     // we still handled the command
  456.         goto error_return;              // no folder, not going to continue
  457.     }
  458.  
  459.     GetFolderStats(lpFolder, &ulSubFolders, &ulReadMsgs, &ulUnReadMsgs);
  460.     wsprintf(szBuffer, "Number of subfolders: %ld\n"
  461.                        "Number of read messages: %ld\n"
  462.                        "Number of unread messages: %ld", 
  463.                        ulSubFolders, ulReadMsgs, ulUnReadMsgs);
  464.  
  465.     MessageBox(m_hWnd, szBuffer, "Sample Extension - Folder Stats", MB_OK);
  466.  
  467.     hr = S_OK;
  468.     
  469.  }
  470.  
  471.  // must use a different technique in Find window
  472.  if (m_context == EECONTEXT_SEARCHVIEWER)  
  473.  {
  474.  
  475.  
  476.     pmecb->GetObject(&lpMDB, (LPMAPIPROP FAR *)&lpFolder);
  477.  
  478.     if (lpFolder == NULL)
  479.     {
  480.         hr = S_OK;     // we still handled the command
  481.         goto error_return;              // no folder, not going to continue
  482.     }
  483.  
  484.     GetFolderStats(lpFolder, &ulSubFolders, &ulReadMsgs, &ulUnReadMsgs);
  485.     wsprintf(szBuffer, "Number of subfolders: %d\n"
  486.                        "Number of read messages: %d\n"
  487.                        "Number of unread messages: %d", 
  488.                        ulSubFolders, ulReadMsgs, ulUnReadMsgs);
  489.  
  490.  
  491.     MessageBox(m_hWnd, szBuffer, "Sample Extension - Folder Stats", MB_OK);
  492.  
  493.     hr = S_OK;
  494.  
  495.  }
  496.  
  497. error_return:
  498.  
  499.     MAPIFreeBuffer(lpeid);
  500.     
  501.     if (NULL != lpSession)
  502.         lpSession->Release();
  503.  
  504.     if (NULL != lpAddrBook)
  505.         lpAddrBook->Release();
  506.  
  507.     if (NULL != lpMDB)
  508.         lpMDB->Release();                        
  509.  
  510.     if (NULL != lpFolder)
  511.         lpFolder->Release();
  512.  
  513.  return hr; 
  514. }
  515.  
  516.  
  517. ///////////////////////////////////////////////////////////////////////////////
  518. //    MyExchExtCommands::InitMenu()
  519. //
  520. //    Parameters
  521. //    pmecb -- pointer to Exchange Callback Interface
  522. //
  523. //    Purpose
  524. //    This method is called by Exchange when the menu of context is about to
  525. //    be activated.  See WM_INITMENU in the Windows API Reference for more
  526. //    information.
  527. //
  528. //    Return Value - none
  529. //
  530.  
  531. STDMETHODIMP_(VOID) MyExchExtCommands::InitMenu(LPEXCHEXTCALLBACK pmecb)
  532. {
  533.  // do nothing
  534.  
  535. }
  536.  
  537. ///////////////////////////////////////////////////////////////////////////////
  538. //    MyExchExtCommands::Help()
  539. //
  540. //    Parameters
  541. //    pmecb -- pointer to Exchange Callback Interface
  542. //    cmdid -- command id
  543. //
  544. //    Purpose
  545. //    Respond when user presses F1 while custom menu item is selected.
  546. //
  547. //    Return Value
  548. //    S_OK -- recognized the command and provided help
  549. //    S_FALSE -- not our command and we didn't provide help
  550. //
  551.  
  552. STDMETHODIMP MyExchExtCommands::Help(LPEXCHEXTCALLBACK pmecb, UINT cmdid)
  553. {
  554.  HRESULT hr;
  555.  
  556.  
  557.  if (cmdid == m_cmdid)
  558.  {
  559.  
  560.    MessageBox(m_hWnd, "Called through IExchExtCommands::Help()\n"
  561.                       "Contained in cmdext32.dll\n\n"
  562.                       "Copyright (c) 1995 Microsoft Corporation.\n"
  563.                       "All rights reserved.",
  564.                       "About Folder Stats Sample Extension", MB_OK);
  565.  
  566.    hr = S_OK;
  567.  } 
  568.  else
  569.    hr = S_FALSE;
  570.  
  571.  return hr;
  572. }
  573.  
  574.  
  575. ///////////////////////////////////////////////////////////////////////////////
  576. //    MyExchExtCommands::QueryHelpText()
  577. //
  578. //    Parameters
  579. //    cmdid -- command id corresponding to menu item activated
  580. //    ulFlags -- identifies either EECQHT_STATUS or EECQHT_TOOLTIP
  581. //    psz -- pointer to buffer to be populated with text to display
  582. //    cch -- count of characters available in psz buffer
  583. //
  584. //    Purpose
  585. //    Exchange calls this function each time it requires to update the status
  586. //    bar text or if it is to display a tooltip on the toolbar.
  587. //
  588. //    Return Value
  589. //    S_OK to indicate our command was handled
  590. //    S_FALSE to tell Exchange it can continue with its function
  591. //
  592.  
  593. STDMETHODIMP MyExchExtCommands::QueryHelpText(UINT cmdid, ULONG ulFlags, 
  594.                                               LPTSTR psz, UINT cch)
  595. {
  596.  
  597.  HRESULT hr;
  598.  
  599.  if (cmdid == m_cmdid)
  600.  {
  601.   if (ulFlags == EECQHT_STATUS)
  602.     lstrcpyn(psz, "Display Stats on Current Folder", cch);
  603.   
  604.   if (ulFlags == EECQHT_TOOLTIP)
  605.     lstrcpyn(psz, "Folder Stats", cch);
  606.  
  607.   hr = S_OK;
  608.  
  609.  }
  610.  else
  611.   hr = S_FALSE;
  612.  
  613.  return hr;
  614. }
  615.  
  616. ///////////////////////////////////////////////////////////////////////////////
  617. //    MyExchExtCommands::QueryButtonInfo()
  618. //
  619. //    Parameters
  620. //    tbid    -- toolbar identifier
  621. //    itbb    -- toolbar button index
  622. //    ptbb    -- pointer to toolbar button structure -- see TBBUTTON structure
  623. //    lpsz    -- point to string describing button
  624. //    cch     -- maximum size of lpsz buffer
  625. //    ulFlags -- EXCHEXT_UNICODE may be specified
  626. //
  627. //    Purpose
  628. //    For Exchange to find out about toolbar button information.
  629. //
  630. //    Return Value
  631. //    S_FALSE - not our button
  632. //    S_OK    - we filled information about our button
  633. //
  634. //    Comments
  635. //    Called for every button installed for toolbars when IExchExtCommands
  636. //    is installed for each context. The lpsz text is used when the Customize
  637. //    Toolbar dialog is displayed.  The text will be displayed next to the
  638. //    button.
  639. //
  640.  
  641. STDMETHODIMP MyExchExtCommands::QueryButtonInfo (ULONG tbid, UINT itbb, 
  642.                             LPTBBUTTON ptbb, LPTSTR lpsz, UINT cch, 
  643.                             ULONG ulFlags)
  644. {
  645.  HRESULT hr = S_FALSE;
  646.  
  647.   if (m_itbb == itbb)
  648.   {
  649.    ptbb->iBitmap = m_itbm;             // see InstallCommands in this source file
  650.    ptbb->idCommand = m_cmdid;
  651.    ptbb->fsState = TBSTATE_ENABLED;
  652.    ptbb->fsStyle = TBSTYLE_BUTTON;
  653.    ptbb->dwData = 0;
  654.    ptbb->iString = -1;
  655.    lstrcpyn(lpsz, "Folder Stats Toolbar Button", cch);
  656.  
  657.    hr = S_OK;
  658.   }
  659.  return hr;
  660. }
  661.  
  662.  
  663. ///////////////////////////////////////////////////////////////////////////////
  664. //    MyExchExtCommands::ResetToolbar()
  665. //
  666. //    Parameters
  667. //    tbid
  668. //    ulFlags
  669. //
  670. //    Purpose
  671. //
  672. //    Return Value  S_OK always
  673. //
  674. STDMETHODIMP MyExchExtCommands::ResetToolbar(ULONG tbid, ULONG ulFlags)
  675. {
  676.  return S_OK;
  677. }
  678.  
  679. ///////////////////////////////////////////////////////////////////////////////
  680. //  IExchExtUserEvents virtual member functions implementation
  681. //
  682.  
  683. ///////////////////////////////////////////////////////////////////////////////
  684. //    MyExchExtUserEvents::QueryInterface()
  685. //
  686. //    Parameters
  687. //    riid   -- Interface ID.
  688. //    ppvObj -- address of interface object pointer.
  689. //
  690. //    Purpose
  691. //    Exchange Client does not call IExchExtUserEvents::QueryInterface().  
  692. //    So return nothing.
  693. //
  694. //    Return Value - none
  695. //
  696.  
  697. STDMETHODIMP MyExchExtUserEvents::QueryInterface(REFIID riid, LPVOID FAR * ppvObj)          
  698. {
  699.     *ppvObj = NULL;
  700.     if (( riid == IID_IExchExtUserEvents) || (riid == IID_IUnknown) )
  701.     {
  702.         *ppvObj = (LPVOID)this;
  703.         // Increase usage count of this object
  704.         AddRef();
  705.         return S_OK;
  706.     }
  707.     return E_NOINTERFACE;
  708. }
  709.  
  710. ///////////////////////////////////////////////////////////////////////////////
  711. //    MyExchExtUserEvents::OnSelectionChange()
  712. //
  713. //    Parameters
  714. //    pmecb  -- pointer to Exchange Callback Object
  715. //    
  716. //
  717. //    Purpose
  718. //    This function is called when the selection in the UI is changed.
  719. //
  720. //    Return Value - none
  721. //
  722. //    Comments
  723. //    OnSelectionChange is called whenever the selection changes either within
  724. //    a pane or is changed between panes.
  725. //
  726.  
  727. STDMETHODIMP_(VOID) MyExchExtUserEvents::OnSelectionChange(LPEXCHEXTCALLBACK pmecb)
  728. {
  729.  static ULONG cbeid;
  730.  static LPENTRYID lpeid = NULL;
  731.  static ULONG ulType;
  732.  static char szMsgClass[50];
  733.  ULONG cbMsgClass;
  734.  ULONG ulMsgFlags;
  735.  HMENU hMenu;
  736.  HRESULT hr;
  737.  UINT cmdid;
  738.  MyExchExtCommands * pExchExtCommands = NULL;
  739.  
  740.  // do not care about enabling or disabling menu item if in the search viewer
  741.  if (m_context == EECONTEXT_SEARCHVIEWER)
  742.     return;
  743.  
  744.  cbMsgClass = 49;
  745.  szMsgClass[0] = '\0';
  746.  
  747.  
  748.  hr = pmecb->GetSelectionItem(0, &cbeid, &lpeid, &ulType, szMsgClass, 
  749.         cbMsgClass, &ulMsgFlags, 0);
  750.  
  751.  if (FAILED(hr))
  752.  {
  753.   goto error_return;
  754.  }
  755.  
  756.  
  757.  pmecb->GetMenu(&hMenu);
  758.  
  759.  hr = m_pExchExt->QueryInterface(IID_IExchExtCommands, (LPVOID *)&pExchExtCommands);
  760.  if (FAILED(hr))
  761.  {
  762.     goto error_return;
  763.  }
  764.  
  765.  cmdid = pExchExtCommands->GetCmdID();
  766.  pExchExtCommands->Release();
  767.  pExchExtCommands = NULL;
  768.  
  769.  
  770.  // enable or disable the command depending if the selected object is
  771.  // a folder or a "non-folder"  Enable if object is a folder.
  772.  if (ulType == MAPI_FOLDER)
  773.  {
  774.     EnableMenuItem(hMenu, cmdid, MF_BYCOMMAND | MF_ENABLED);
  775.  }
  776.  else
  777.  {
  778.     EnableMenuItem(hMenu, cmdid, MF_BYCOMMAND | MF_GRAYED);
  779.  }
  780.  
  781.  
  782. error_return:
  783.  
  784.  if (lpeid != NULL)
  785.     MAPIFreeBuffer(lpeid);
  786.  
  787. }
  788.  
  789.  
  790. ///////////////////////////////////////////////////////////////////////////////
  791. //    MyExchExtUserEvents::OnObjectChange()
  792. //
  793. //    Parameters
  794. //    pmecb  -- pointer to Exchange Callback Object
  795. //    
  796. //
  797. //    Purpose
  798. //    This function is called when the selection in the UI is to a different
  799. //    of object on the left pane.
  800. //
  801. //    Return Value - none
  802. //
  803. //    Comments
  804. //    OnObjectChange is called whenever the selection is changed between 
  805. //    objects in the left pane only.  Change in selection between folders, 
  806. //    subfolders or container object in the left pane will be reflected with a
  807. //    call to OnObjectChange.  Change in selection between objects (messages, 
  808. //    subfolders) in the right pane will not call OnObjectChange, only 
  809. //    OnSelectionChange.
  810. //
  811.  
  812. STDMETHODIMP_(VOID) MyExchExtUserEvents::OnObjectChange(LPEXCHEXTCALLBACK pmecb)
  813. {
  814.  // no need to handle this one
  815. }
  816.  
  817.  
  818.  
  819. ///////////////////////////////////////////////////////////////////////////////
  820. //  Helper functions to accomplish this extension's task
  821. //
  822.  
  823.  
  824. ///////////////////////////////////////////////////////////////////////////////
  825. //    GetFolderStats()
  826. //
  827. //    Parameters
  828. //    lpFolder      -- pointer to Folder of which to get statistics
  829. //    pulFolder     -- pointer to buffer to be filled with number of subfolders
  830. //    pulReadMsgs   -- pointer to buffer to be filled with number of read 
  831. //                     messages
  832. //    pulUnReadMsgs -- pointer to buffer to be filled with number of unread
  833. //                     messages
  834. //
  835. //    Purpose
  836. //    This function gathers information information about the given message
  837. //    folder.  It calculates the number of subfolders, read messages, and
  838. //    unread messages.
  839. //
  840. //    Return Value - none
  841. //
  842. //    Comments
  843. //    The Find window results folder only contains messages and not subfolders
  844. //    so it sets the number of subfolders to zero
  845. //
  846.  
  847. void GetFolderStats(LPMAPIFOLDER lpFolder, ULONG FAR * pulSubFolders, 
  848.                     ULONG FAR * pulReadMsgs, ULONG FAR * pulUnReadMsgs)
  849. {
  850.  HRESULT hr = 0;
  851.  LPMAPITABLE lpTable = NULL;
  852.  ULONG ulRows = 0;
  853.  UINT u;
  854.  LPSRowSet lpRows = NULL;
  855.  
  856.  enum { MESSAGE_FLAGS, STATTAGS };
  857.  
  858.  SizedSPropTagArray(STATTAGS,  MsgTags) =
  859.       { STATTAGS, 
  860.         { 
  861.          PR_MESSAGE_FLAGS        // contains read/unread flags
  862.         } 
  863.       };
  864.  
  865.  
  866.  hr = lpFolder->GetHierarchyTable(0, &lpTable);   // get table of subfolders
  867.  if (MAPI_E_NO_SUPPORT == hr)                     // Find window folder doesn't 
  868.     *pulSubFolders = 0;                           // support GetHierarchyTable
  869.     
  870.  else if (S_OK != hr)              // some other error
  871.     goto error_return;
  872.  
  873.  if (lpTable != NULL)
  874.  {
  875.     lpTable->GetRowCount(0, pulSubFolders);
  876.     lpTable->Release();
  877.     lpTable =NULL;
  878.  }
  879.  
  880.  hr = lpFolder->GetContentsTable(0, &lpTable);    // get table of messages
  881.  if (S_OK != hr)
  882.     goto error_return;
  883.  
  884.  hr = lpTable->SetColumns((LPSPropTagArray)&MsgTags, 0);
  885.  if (S_OK != hr)
  886.     goto error_return;
  887.  
  888.  lpTable->GetRowCount(0, &ulRows);
  889.  hr = lpTable->QueryRows(ulRows, 0, &lpRows);
  890.  if (S_OK != hr)
  891.     goto error_return;
  892.  
  893.  *pulReadMsgs = 0;
  894.  *pulUnReadMsgs = 0;
  895.  
  896.  for (u=0; u<ulRows; u++)
  897.  {
  898.  
  899.   if (MSGFLAG_READ & lpRows->aRow[u].lpProps[MESSAGE_FLAGS].Value.ul)
  900.     (*pulReadMsgs)++;
  901.   else
  902.     (*pulUnReadMsgs)++;
  903.  
  904.  }
  905.  
  906.  
  907. error_return:
  908.  
  909.  if (NULL != lpTable)
  910.     lpTable->Release();
  911.  
  912.  if (NULL != lpRows)
  913.     FreeProws(lpRows);
  914.  
  915. }
  916.