MFCMAPI Wiki & Documentation Rss Feed

Project Description
MFCMAPI uses Microsoft's published APIs to provide access to MAPI stores through a graphical user interface. Its purpose is to facilitate investigation of Exchange and Outlook issues and to provide developers with a canonical sample for MAPI development.

November 2009 Release of MFCMAPI

Help/Feedback
For assistance using MFCMAPI, developing add-ins, or general MAPI development, consult the documentation. Find a bug? Need help? Have a suggestion? Use the Discussions or Issue Tracker tabs or contact me through my blog: http://blogs.msdn.com/stephen_griffin/contact.aspx.

Updated Wiki: Documentation

sgriffin — Thu, 05 Nov 2009 03:01:57 GMT

MFCMAPI Resources
MFCMAPI on Facebook
A Brief History of MFCMAPI
User Guide (ignore the Installing section)
Blog entries on MFCMAPI/MAPI Editor

SGriffin's MAPI Internals : MFCMAPI News Feed

OpenStreamOnFile vs Unicode Files

Tuesday, September 29, 2009 | From SGriffin's MAPI Internals : MFCMAPI

OpenStreamOnFile vs Unicode Files

Tuesday, September 29, 2009 | From SGriffin's MAPI Internals : MFCMAPI

September 2009 Release of MFCMAPI

Thursday, September 10, 2009 | From SGriffin's MAPI Internals : MFCMAPI

SGriffin's MAPI Internals : MFCMAPI News Feed

MFCMAPI Add-Ins
MFCMAPI Addin Development
Sample add-in for creating contacts, appointments, tasks, etc.

General MAPI/Exchange Development Resources
MSDN MAPI Documentation
Exchange Protocol Documentation
Exchange MAPI Implementation Download
MAPI Mail List
ExchangeDev Blog
EHLO Blog

Newsgroups
microsoft.public.win32.programmer.messaging
microsoft.public.platformsdk.mapi

Updated Wiki: Home

sgriffin — Thu, 05 Nov 2009 03:00:45 GMT

September 2009 Release of MFCMAPI

Updated Wiki: Home

sgriffin — Thu, 05 Nov 2009 02:56:24 GMT

Click here to download the latest (September 2009 Release) build of MFCMAPI

Help/Feedback
Find a bug? Need help? Have a suggestion? Use the Discussions or Issue Tracker tabs or contact me through my blog: http://blogs.msdn.com/stephen_griffin/contact.aspx.

Updated Wiki: Documentation

sgriffin — Thu, 05 Nov 2009 02:56:16 GMT

MFCMAPI Resources
MFCMAPI on Facebook
A Brief History of MFCMAPI
User Guide (ignore the Installing section)
Blog entries on MFCMAPI/MAPI Editor

SGriffin's MAPI Internals : MFCMAPI News Feed

OpenStreamOnFile vs Unicode Files

Tuesday, September 29, 2009 | From SGriffin's MAPI Internals : MFCMAPI

OpenStreamOnFile vs Unicode Files

Tuesday, September 29, 2009 | From SGriffin's MAPI Internals : MFCMAPI

September 2009 Release of MFCMAPI

Thursday, September 10, 2009 | From SGriffin's MAPI Internals : MFCMAPI

SGriffin's MAPI Internals : MFCMAPI News Feed

MFCMAPI Add-Ins
MFCMAPI Addin Development
Sample add-in for creating contacts, appointments, tasks, etc.

General MAPI/Exchange Development Resources
MSDN MAPI Documentation
Exchange Protocol Documentation
Exchange MAPI Implementation Download
MAPI Mail List
ExchangeDev Blog
EHLO Blog

Newsgroups
microsoft.public.win32.programmer.messaging
microsoft.public.platformsdk.mapi

Updated Wiki: Home

sgriffin — Thu, 05 Nov 2009 02:55:28 GMT

Click here to download the latest (September 2009 Release) build of MFCMAPI

MFCMAPI Resources
MFCMAPI on Facebook
A Brief History of MFCMAPI
User Guide (ignore the Installing section)
Blog entries on MFCMAPI/MAPI Editor

SGriffin's MAPI Internals : MFCMAPI News Feed

OpenStreamOnFile vs Unicode Files

Tuesday, September 29, 2009 | From SGriffin's MAPI Internals : MFCMAPI

OpenStreamOnFile vs Unicode Files

Tuesday, September 29, 2009 | From SGriffin's MAPI Internals : MFCMAPI

September 2009 Release of MFCMAPI

Thursday, September 10, 2009 | From SGriffin's MAPI Internals : MFCMAPI

SGriffin's MAPI Internals : MFCMAPI News Feed

Help/Feedback
Find a bug? Need help? Have a suggestion? Use the Discussions or Issue Tracker tabs or contact me through my blog: http://blogs.msdn.com/stephen_griffin/contact.aspx.

Updated Wiki: Documentation

sgriffin — Thu, 05 Nov 2009 02:55:12 GMT

MFCMAPI Add-Ins
MFCMAPI Addin Development
Sample add-in for creating contacts, appointments, tasks, etc.

General MAPI/Exchange Development Resources
MSDN MAPI Documentation
Exchange Protocol Documentation
Exchange MAPI Implementation Download
MAPI Mail List
ExchangeDev Blog
EHLO Blog

Newsgroups
microsoft.public.win32.programmer.messaging
microsoft.public.platformsdk.mapi

Updated Wiki: CreateOutlookItemsAddin

sgriffin — Thu, 05 Nov 2009 02:52:48 GMT

This add-in is the sample code that accompanies the MSDN technical article, Using MAPI to Create Outlook 2007 Items, by Randy Byrne and Stephen Griffin. Any updates to this add-in will be noted on this page.

Click here to download the CreateOutlookItemsAddin project.

The add-in architecture is documented here: MFCMAPI Addin Development

Version History

1.0 (06/12/08) Original version for Using MAPI to Create Outlook 2007 Items article.
- Creates contacts.
2.0 (08/28/08) Update for the upcoming Outlook MAPI reference. New features:
- Creates recurring appointments
- Creates recurring tasks
- Creates/sends mail items

Updated Wiki: MFCMAPI Addin Development

sgriffin — Thu, 05 Nov 2009 02:52:21 GMT

The model for add-in development for MFCMAPI is quite simple. Build a DLL that exports a few functions, drop said DLL into the same directory as MFCMAPI, and MFCMAPI will find it when it starts up. No messy config files, no fiddling around in the directory. Wanna disable an add-in? Just rename it so it's not a DLL anymore.

The core of an MFCMAPI addin is the header file: mfcmapi.h. This file contains the definitions for the functions you'll need to implement and export from your DLL, as well as definitions for functions your add-in can import from MFCMAPI.

To get you started, here's a test add-in: testaddin.zip. It doesn't do much except exercise the various add-in entry points. It was developed in sync with the addition of add-ins to the code base as part of my testing.

Documentation

Stuff the Add-In implements

LoadAddIn
This function lets the add-in know we're here and get its name. You have to implement this one for MFCMAPI to know you're an add-in.

UnloadAddIn
MFCMAPI will call this when unloading add-ins. This is a good time to free resources.

GetMenus
Return an array describing the menu entries you'd like to have, when you want them to be enabled, and what information you want passed back to you when your menu is invoked.

CallMenu
Let's you know one of your menu items has been selected, along with a wealth of contextual information.

GetPropTags
Return an array of property names for MFCMAPI to use in decoding properties.

GetPropTypes
Return an array of property types for MFCMAPI to use in decoding properties.

GetPropGuids
Return an array of property guids for MFCMAPI to use in decoding properties.

GetNameIDs
Returns an array of named property mappings for MFCMAPI to use in decoding properties.

GetPropFlags
Return an array of flag parsing information for MFCMAPI to use in decoding properties.

Stuff MFCMAPI implements

AddInLog
Call this to generate debug output through MFCMAPI's own logging routines.

SimpleDialog
A quick and dirty dialog.

ComplexDialog
A harder to use, but much more featured dialog that can be used to get user input.

FreeDialogResult
If you use ComplexDialog, you might get a structure back with the results. This function frees that structure.

GetMAPIModule
Get a handle to the MAPI binary that MFCMAPI loaded, or ask MFCMAPI to go ahead and load MAPI.

Notes

A well behaved add-in will not link mapi32.lib. Instead, it will use GetMAPIModule to get a handle to MAPI, then GetProcAddress to get any exports you need. The reason for not statically linking is to allow MFCMAPI the flexibility to load MAPI itself from custom locations.

Also, a well behaved add-in is not written in .Net, since MAPI and .Net aren't supported in combination. No bugs will be taken on this.