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.