一、概述
本文主要讲述如何使用Visual C++用MAPI编写E-mail程序。MAPI是包含在Windows之中的，因此不需要安装其他额外的部件。MAPI有以下三种形式：
SMAPI，Simple MAPI，简单的MAPI
CMC，Common Messaging Calls，一般通讯调用
完整的MAPI
SMAPI和CMC都包含在完整的MAPI中，当用户想执行一些高级操作，比如编写自己的E-mail服务器的时候，必须使用完整的MAPI。本文主要阐述如何编写能够收发电子邮件的程序，因此使用SMAPI就足够了。
二、编写电子邮件程序
3-1 初始化MAPI
要使用MAPI，必须首先对它进行初始化。初始化包括以下三个步骤：
装载MAPI32.DLL动态链接库
找到想要调用的MAPI函数地址
登录到电子邮件对象
3-1-1 装载MAPI32.DLL
要装载MAPI，用户必须程序运行时动态的装载一个动态链接库。LoadLibrary函数提供了此功能，它定位一个动态链接库，并返回HINSTANCE局柄（需要保存该句柄）。
LoadLibrary的语法如下：
LoadLibrary ( lpLibFileName );
其中lpLibFileName为LPCTSTR结构变量，
是所要调用的库的路径和名称。
程序示例：
// 调用MAPI32.DLL并计算函数地址
HINSTANCE hInstMail;
hInstMail = ::LoadLibrary ( “MAPI32.DLL” );
if ( hInstMail == NULL )
{
// 错误处理
// 受篇幅限制,下面的错误处理部分省略
}
3-1-2 确定函数地址
由于MAPI32.DLL是被动态装载的，因此不知道所要调用的函数地址，也就不能一开始就调用它们，而要通过函数名获得函数的地址，并在动态链接库中查找每一个函数并核实。因此首先必须为这些函数声明指针
程序示例：
// 为MAPI32.DLL中的函数声明函数指针
ULONG (PASCAL *lpfnMAPISendMail) (LHANDLE lhSession,
ULONG ulUIParam, lpMapiMessage lpMessage,
FLAGS flFlags, ULONG ulReserved);
ULONG (PASCAL *lpfnMAPIResolveName) (LHANDLE lhSession,
ULONG ulUIParam, LPTSTR lpszName,
FLAGS ulFlags, ULONG ulReserved,
lpMapiRecipDesc FAR *lppRecip);
ULONG (FAR PASCAL *lpfnMAPILogon)(ULONG ulUIParam,
LPSTR lpszProfileName, LPSTR lpszPassword,
FLAGS flFlags, ULONG ulReserved,
LPLHANDLE lplhSession);
ULONG (FAR PASCAL *lpfnMAPILogoff)(LHANDLE lhSession,
ULONG ulUIParam, FLAGS flFlags,
ULONG ulReserved);
ULONG (FAR PASCAL *lpfnMAPIFreeBuffer)(LPVOID lpBuffer);
ULONG (FAR PASCAL *lpfnMAPIAddress)(LHANDLE lhSession,
ULONG ulUIParam, LPSTR lpszCaption,
ULONG nEditFields, LPSTR lpszLabels,
ULONG nRecips, lpMapiRecipDesc lpRecips,
FLAGS flFlags, ULONG ulReserved,
LPULONG lpnNewRecips,
lpMapiRecipDesc FAR *lppNewRecips);
ULONG (FAR PASCAL *lpfnMAPIFindNext)(LHANDLE lhSession,
ULONG ulUIParam, LPSTR lpszMessageType,
LPSTR lpszSeedMessageID, FLAGS flFlags,
ULONG ulReserved, LPSTR lpszMessageID);
ULONG (FAR PASCAL *lpfnMAPIReadMail)(LHANDLE lhSession,
ULONG ulUIParam, LPSTR lpszMessageID,
FLAGS flFlags, ULONG ulReserved,
lpMapiMessage FAR *lppMessage);
为了决定每一个函数的地址，必须为每一个函数调用GetProcAddress。
GetProcAddress的语法为：
GetProcAddress (hModule, lpProcName);
其中，hModule为HMODULE结构，是所调用DLL模块的句柄；
lpProcName为LPCSTR结构，是函数名称。
程序示例：
// 找到MAPI32.DLL函数的地址，并将它们保存在函数指针变量里
(FARPROC%26amp;) lpfnMAPISendMail = GetProcAddress(hInstMail,
“MAPISendMail”);
(FARPROC%26amp;) lpfnMAPIResolveName = GetProcAddress(
hInstMail, “MAPIResolveName”);
(FARPROC%26amp;) lpfnMAPILogon = GetProcAddress(hInstMail,
“MAPILogon”);
(FARPROC%26amp;) lpfnMAPILogoff = GetProcAddress(hInstMail,
“MAPILogoff”);
(FARPROC%26amp;) lpfnMAPIFreeBuffer = GetProcAddress(
hInstMail, “MAPIFreeBuffer”);
(FARPROC%26amp;) lpfnMAPIAddress = GetProcAddress(hInstMail,
“MAPIAddress”);
(FARPROC%26amp;) lpfnMAPIFindNext = GetProcAddress(hInstMail,
“MAPIFindNext”);
(FARPROC%26amp;) lpfnMAPIReadMail = GetProcAddress(hInstMail,
“MAPIReadMail”);
3-1-3 登录到电子邮件对象
用户必须在电子邮件系统中登录，才能实现MAPI的各种功能。MAPI提供了登录的三种选择：
登录到一个已经存在的对象。
登录到一个新对象，用编程的方法确定解释新信息。
使用对话框提示用户登录。
我们通常选择登录到一个已经存在的电子邮件对象，因为网络合作用户通常会保持自己的电子邮件程序处于激活状态。登录通常使用MAPI提供的函数lpfnMAPILogon。
lpfnMAPILogon的语法为：
lpfnMAPILogon (lpszProfileName, lpszPassword, flFlags,
ulReserved, lplhSession );
其中，lpszProfileName指向一个256字符以内的登录名称，lpszPassword指向密码，它们均为LPTSTR结构。flFlags为FLAGS结构，其值详见表1。ulReserved必须为0。lplhSession为输出SMAPI的句柄。
表1：lpfnMAPILogon函数中flFlags的值
值 意义
MAPI_FORCE_DOWNLOAD
在函数调用返回之前下载用户的所有邮件。
如果MAPI_FORCE_DOWNLOAD没有被设置，
那么信件能够在函数调用返回后在后台被下载。
MAPI_NEW_SESSION 建立一个新会话，
而不是获得环境的共享会话。如果MAPI_NEW_SESSION没有被设置，
MAPILogon使用现有的共享会话。
MAPI_LOGON_UI 显示一个登录对话框来提示用户输入登录信息。
例如Outlook检查用户电子邮件时便是如此。
MAPI_PASSWORD_UI MAPILogon只允许用户输入电子邮件的密码，
而不许改动账号。
程序示例：
LHANDLE lhSession;
ULONG lResult = lpfnMAPILogon(0, NULL, NULL, 0, 0,
如果您对本文有任何疑问或者建议，请到讨论区发表您的意见:
>>
论坛入口 <<
上一篇：
用C＋＋Builder编写发送电子邮件软件 下一篇：
用 SMTP 发送带验证带附件的邮件
【文章评论】
【收藏本文】
【推荐好友】
【打印本文】
【我要投稿】 【论坛讨论】
