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 / manager.sh / readme.txt < prev    next >
Encoding:
Text File  |  1996-04-06  |  5.9 KB  |  126 lines
  1. Sample Message Hook
  2.  
  3.  
  4. The Manager.Sh sample is a sample spooler message hook provider (SMH32.DLL).
  5. The sample spooler hook is an example of a reasonably clever extension to
  6. MAPI which uses the documented MAPI spooler message hook interfaces to
  7. categorize and archive sent and received mail.
  8.  
  9. Installation
  10. ------------
  11.  
  12. The sample spooler hook is shipped in source form for 32-bit platforms only.
  13. You must build SMH32.DLL first. For the DLL to build successfully, you must
  14. have an SDK that includes the import libraries for the Windows 95 common
  15. controls installed. For the DLL to run successfully on Windows NT 3.5, the
  16. Windows 95 compatible common controls must be installed. Windows NT 3.51
  17. includes these controls.
  18.  
  19. After building SMH32.DLL, copy it to the system directory of the target
  20. machine, then use the mergeini utility to merge smh.inf into mapisvc.inf.
  21.  
  22. For example:
  23.  
  24.     copy smh32.dll c:\windows\system
  25.     mergeini.exe -m .\smh.inf
  26.     
  27. Start the control panel and start the Mail and Fax applet. Select "Add..."
  28. on the Services page of Profile Properties and double-click Sample Mail
  29. Handler.
  30.  
  31. Configuration
  32. -------------
  33.  
  34. The sample message hook has a three-page property sheet interface for
  35. interactive configuration, which is accessible through service provider
  36. logon, through the ServiceEntry call, and through the
  37. IMAPIStatus::SettingsDialog method.
  38.  
  39. When you first add the sample message hook to the profile configuration,
  40. you will need to log off the profile if you are already logged in, and
  41. then log in again before the change will take effect.
  42.  
  43. General Page
  44. ------------
  45.  
  46. Incoming mail -- Use the "Enable filtering of inbound messages" checkbox
  47. to start inbound/outbound mail "filter"ing. Use the "Add unread messages
  48. folder to hierarchy" checkbox to create a search folder containing all
  49. unread messages for easier access.
  50.  
  51. Sent mail -- Use the "Archive sent mail into monthly subfolders" checkbox
  52. to instruct the hook processor to categorize sent mail by date and to use
  53. and create subfolders based on the month of submission to contain these
  54. messages. Use the "Archive sent mail monthly folders by year" checkbox to
  55. further organize the archives by year (e.g. sent mail\year\month folder
  56. hierarchy).
  57.  
  58. Deleted mail -- Use the "Archive deleted mail into monthly subfolders"
  59. checkbox to instruct the hook processor to categorize deleted mail by date
  60. and to use and create subfolders based on the month of creation to contain
  61. these messages. Use the "Archive deleted mail monthly folders by year"
  62. checkbox to further organize the archives by year
  63. (e.g. deleted mail\year\month folder hierarchy).
  64.  
  65. Filters Page
  66. ------------
  67.  
  68. This page displays a listbox containing all the filters/actions which have
  69. been defined for this profile. The sample hook processor traverses this
  70. list from top to bottom in determining the disposition of a newly
  71. sent/received message. The first rule that "fires" will be the only one
  72. which is applied to the message in question.
  73.  
  74. To add a filter rule, use the "New" button. To change a rule, select it
  75. and use the "Edit" button. To delete a rule, select it and use the "Delete"
  76. button. To arrange the ordering of rules, select the rule whose position in
  77. the list needs changing and use the up/down arrow buttons to make the
  78. appropriate change.
  79.  
  80. When you select "New" or "Edit", the filter description dialog will be
  81. presented to you. In this dialog you should enter a display name for the
  82. filter rule that can be used for the listbox, select one of the filtering
  83. criteria (self-explanatory). Enter the appropriate string in "Value contains"
  84. (in the case of recipients, the filter compares both the display name and
  85. the email address), the display name (as shown in the left-hand pane of the
  86. Exchange mail client) of the target store in the "Target Store" field, and
  87. the display name (again as shown in the Exchange mail client) of the folder
  88. to which you want mail matching this filter rule to be copied in the "Target
  89. Folder" field. The hook provider will create folders if need be; to specify
  90. folders in a hierarchy, use a backslash character (e.g. My Mail\Clever
  91. Sayings). To get the negative effect (ie this rule fires for a message not
  92. matching the criteria), set the "Filter messages that do not match this
  93. criteria" checkbox. To disable a filter without deleting it, you set the
  94. "Discontinue the filtering of messages matching this criteria" checkbox. To
  95. choose archiving options for the filter (like in the Sent Mail / Deleted Mail
  96. option above) you may set the appropriate checkboxes for the rule.
  97.  
  98. Exclusions Page
  99. ---------------
  100.  
  101. This page displays a listbox containing all the message classes for which
  102. filtering is disabled. The sample hook processor traverses this list from top
  103. to bottom in determining whether it should filter a newly sent/received
  104. message. If any message class matches, rules processing will not occur for
  105. that message.
  106.  
  107. To add a message class, use the New button. To delete a rule, select it and
  108. use the Delete button. To arrange the ordering of rules, select the rule
  109. whose position in the list needs changing and use the up/down arrow buttons
  110. to make the appropriate change.
  111.  
  112. Known Problems
  113. --------------
  114.  
  115. Some of the sample hook's features will not work if you use a tightly-coupled
  116. store and transport as your default message store. The archiving of sent and
  117. received mail will not work, because the hook entry points are never called
  118. when the message store server receives mail. Other features, such as archiving
  119. of deleted messages and auto-reply, will work normally.
  120.  
  121. The hook only can be built on/for 32-bit platforms (this is a limitation of
  122. the sample provider, not of the hook interface itself). The Unread Messages
  123. folder doesn't always seem to be accessable from the Exchange client. The
  124. "Filter messages that do not match this criteria" checkbox doesn't always
  125. seem to work.
  126.