Platform SDK: MAPI

Simple MAPI

Simple MAPI is a set of functions and related data structures you can use to add messaging functionality to C, C++, or Visual Basic Windows applications. The Simple MAPI functions are available in C and C++ and Visual Basic versions.

The following table provides an overview of the Simple MAPI functions.

Simple MAPI function Description
MAPIAddress Addresses a message.
MAPIDeleteMail Deletes a message.
MAPIDetails Displays a recipient-details dialog box.
MAPIFindNext Returns the identifier of the first or next message of a specified type.
MAPIFreeBuffer Frees memory allocated by the messaging system.
MAPILogoff Ends a session with the messaging system.
MAPILogon Establishes a messaging session.
MAPIReadMail Reads a message.
MAPIResolveName Displays a dialog box to resolve an ambiguous recipient name.
MAPISaveMail Saves a message.
MAPISendDocuments Sends a standard message using a dialog box.
MAPISendMail Sends a message, allowing greater flexibility than MAPISendDocuments in message generation.

To use the Simple MAPI functions, compile your source code with MAPI.H. MAPI.H contains definitions for all of the functions, return value constants, and data types. To call a Simple MAPI function, load MAPI.DLL and use the Win32 GetProcAddress function to acquire an entry point. The function calling conventions should be FAR PASCAL.

All strings passed to all MAPI calls and returned by all MAPI calls are null-terminated and must be specified in the current character set or code page of the caller's operating system process.