Platform SDK: MAPI

Using the MAPI Utilities

The MAPI utilities are made up of table data and property data objects and a variety of functions to support miscellaneous features. It is possible for a client to need only these utilities and not have to log on to the MAPI subsystem to establish a connection with service providers. If your client fits into this category, call the API function ScInitMapiUtil rather than the MAPIInitialize function at initialization time.

ScInitMapiUtil enables clients to use utility functions that require MAPI allocators, but that do not ask for the allocators explicitly. When it is time to shut down, call DeinitMapiUtil to free resources rather than MAPIUninitialize. Clients that never call MAPIInitialize should not call MAPIUninitialize.

If you have called ScInitMapiUtil rather than MAPIInitialize and are using tables through the ITableData methods rather than through the IMAPITable methods, be aware that table notifications will not work. Notifications require the use of the MAPI libraries and IMAPITable.