4.44. MAPI - Messaging Applications Programming Interface unit
Targets: Win32 only
This module provides the interface to the Microsoft's Simple Messaging
Application Programming Interface (MAPI).
About the Simple MAPI:
Microsoft's Simple Messaging Application Programming Interface (MAPI)
is a set of functions that applications use to create, manipulate,
transfer, and store messages. Simple MAPI gives application developers
freedom to define the purpose and contents> of messages, and flexibility
in their management of stored messages. MAPI provides a common interface
that application developers use to create messaging-enabled and
messaging-aware applications independent of the underlying messaging system.
Simple MAPI includes routines intended for use by applications, such as
spreadsheet programs and word processors that must become messaging-aware.
You can also use Simple MAPI to build custom messaging applications such as
a calendaring and scheduling program. These applications are typically
concerned with the easy exchange of datafiles and simple messages generated
by these applications.
This small, easy-to-use set of APIs allows applications to access inbound
and outbound messages. Although designed to be called from C programs,
you can call the functions with little or no parameter modification from
application-specific and standalone scripting packages such as Visual Basic,
Actor, Smalltalk, and Object Vision. The target audience is application
developers who have documents or other application data within their
applications that they want to send or receive as messages. Because of
its ease of use, Simple MAPI allows applications to become messaging-aware.
Consider the following example:
A network monitoring application generates a network usage report.
Instead of printing the report or requiring a user to cut/paste it
into a message, the application can mail the report directly to a
Microsoft Excel or Toolbook application that consolidates the information
and forwards it on to a network operations center.
The Simple MAPI functions include a user interface, but you can call
the APIs non-interactively (not generating any user interface (UI)).
The implementation provides the user interface is provided to allow
the user to address the message, enter a note, and send the message.
MAPI does not define the exact style of the user interface, and it can
be different on each platform that implements Simple MAPI.
If the user has not yet logged-in to the messaging system, the calls
prompt, as appropriate, for the required session parameters, for example,
user name and password.
For more info look the "Simple MAPI" in WIN32.HLP
and MAPI.HLP.