VC++编写电子程序
.diybl. 时间：2008-08-27 作者:佚名 编辑:本站 点击： 635 [评论]
VC++编写电子程序
一、概述
---- 本文主要讲述如何使用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&) lpfnMAPISendMail = GetProcAddress(hInstMail, “MAPISendMail”);
(FARPROC&) lpfnMAPIResolveName = GetProcAddress( hInstMail, “MAPIResolveName”);
(FARPROC&) lpfnMAPILogon = GetProcAddress(hInstMail, “MAPILogon”);
(FARPROC&) lpfnMAPILogoff = GetProcAddress(hInstMail, “MAPILogoff”);
(FARPROC&) lpfnMAPIFreeBuffer = GetProcAddress( hInstMail, “MAPIFreeBuffer”);
(FARPROC&) lpfnMAPIAddress = GetProcAddress(hInstMail, “MAPIAddress”);
(FARPROC&) lpfnMAPIFindNext = GetProcAddress(hInstMail, “MAPIFindNext”);
(FARPROC&) 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,
&lhSession);
if (lResult != SUCCESS_SUCCESS)
//SUCCESS_SUCCESS在MAPI.H中被定义 {
// 错误处理 }
3-2 阅读电子
---- MAPIFindNext和MAPIReadMail使用与阅读E-mail的两个基本函数。MAPIFindNext用于定位第一
封或下一封电子并返回标识号，MAPIReadMail返回以该标识号为基础的电子的容。另外， 一个常用的函数是MAPIFreeBuffer，用于释放存。 3-2-1 定位到第一封信
---- 要找到第一封信，需要使用MAPIFindNext函数，其函数声明如下： ULONG FAR PASCAL MAPIFindNext(LHANDLE lhSession, ULONG ulUIParam, LPTSTR lpszMessageType, LPTSTR lpszSeedMessageID, FLAGS flFlags, ULONG ulReserved, LPTSTR lpszMessageID )
---- 其中，lhSession为提交SMAPI的会话句柄 ；ulUIParam为父窗体的句柄；lpszMessageType
指向一个字符串，用来鉴别类型，并加以查找；lpszSeedMessageID为指向起始信息ID的指针， 其值为0时，MAPIFindNext获得第一封电子；flFlags的值见表2；ulReserved必须为0； lpszMessageID为输出值，它是指向信息ID地址的指针。 ---- 表2：MAPIFindNext函数中flFlags的值 值 意义
MAPI_GUARANTEE_FIFO 按发送的时间顺序接受电子。 MAPI_LONG_MSGID 返回信件标识符可达512字符。 MAPI_UNREAD_ONLY 只列举没有阅读过的电子。 程序示例：
// 找到第一条没有阅读的电子 char pMessageID [513];
ULONG lResult = lpfnMAPIFindNext(lhSession, NULL, NULL, NULL, MAPI_LONG_MSGID | MAPI_UNREAD_ONLY, 0, pMessageID); 3-2-2 阅读信息
当信件ID被获取后，就可以调用MAPIReadMail
阅读实际的E-mail信息了。MAPIReadMail的函数声明如下： ULONG FAR PASCAL MAPIReadMail(LHANDLE lhSession, ULONG ulUIParam, LPTSTR lpszMessageID, FLAGS flFlags, ULONG ulReserved, lpMapiMessage FAR * lppMessage);
其中，lppMessage为指向MapiMessage的指针；
除flFlags外的其他参数与lpfnFindNext函数的同名参数意义相同， flFlags参数的值见表3：
表3：MAPIReadMail函数中flFlags的值： 值 意义
MAPI_BODY_AS_FILE 将信息写到一个临时文件中， 并且将它作为第一个附件添加到附件列表中。 MAPI_ENVELOPE_ONLY 只读取标题。 MAPI_PEEK 读完之后不把它标记为“已读”。
MAPI_SUPPRESS_ATTACH MAPIReadMail函数不拷贝附件， 但是将文本写入MapiMessage结构中。 程序示例： // 读取电子
long nFlags = MAPI_SUPPRESS_ATTACH; if (!bMarkAsRead)
nFlags = nFlags | MAPI_PEEK;
lResult = lpfnMAPIReadMail(lhSession, NULL, pMessageID, nFlags, 0, &pMessage);
if (lResult != SUCCESS_SUCCESS); return false;
如果调用成功，就可以访问MapiMessage结构了（使用pMessage）： pMessage- >ulReserved：0 pMessage- >lpszSubject：标题 pMessage- >lpszNoteText：信息
pMessage- >lpszMessageType：类型 pMessage- >DateReceived：接收时间
pMessage- >lpszConversationID：所属的会话线程ID pMessage- >flFlags：其值见表4 表4：MapiMessage结构中的flFlags 值 意义
MAPI_RECEIPT_REQUESTED 接收通知被申请。 客户端应用程序在发送消息时设置该项。 MAPI_SENT 已被发送。
MAPI_UNREAD 是“未读”状态。
pMessage- >lpOriginator：指向MapiRecipDesc结构，包含发件人信息。 pMessage- >nRecipCount：信件者数目。
pMessage- >lpRecips：指向MapiRecipDesc结构数组，包含接收者信息。 pMessage- >nFileCount：附件数量。
pMessage- >lpFiles：指向MapiFileDesc结构数组， 每一个结构包含一个文件附件。
3-2-3 释放存
---- 在访问另一条信件以前应当释放存，否则会出现存泄漏。
vc编写电子邮件程序文件
