表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 释放内存
---- 在访问另一条信件以前应当释放内存，否则会出现内存泄漏。
程序示例：
// 释放内存
lpfnMAPIFreeBuffer(pMessage);
3-2-4 定位到下一条信件
定位到下一条信件依然使用MAPIFindNext函数，
该函数声明及参数意义详见3-2-1节。下面示范如何定位到下一条信件。 程序示例：
// 定位到下一条没有阅读的信件
ULONG lResult = lpfnMAPIFindNext(lhSession, NULL, NULL,
pMessageID, MAPI_LONG_MSGID|MAPI_UNREAD_ONLY,
0, pMessageID);
3-3 发送电子邮件
---- 发送电子邮件的一般步骤：
---- 1． 建立MapiMessage结构对象
---- 2． 调用MAPIResolveName使发送者名称合法
---- 3． 添加附件
---- 4． 调用MAPISendMail发送电子邮件
---- 5． 调用MAPIFreeBuffer释放内存
---- 下面详细分别详细阐述。
3-3-1 建立MapiMessage结构对象
---- 对于MapiMessage结构，3-2-2节已经做过介绍，下面一步步介绍如何设置其中的值：
---- 1． 为MapiMessage对象分配内存：
MapiMessage message;
Memset(&message, 0, sizeof(message));
---- 2． 将ulReserved设置为0：
message.ulReserved = 0;
---- 3． 设置信息类型指针lpszMessageType，可以为NULL：
message.lpszMessageType = NULL;
---- 4． 设置信件标题（lpszSubject）：
char subject[512];
strcpy(subject, sSubject);
message.lpszSubject = subject;
---- 5． 设置信件内容：
char text[5000];
strcpy(text, sMessage);
message.lpszNoteText = text;
---- 6． 设置flFlags标识，详见3-2-2节中表4：
message.flFlags = MAPI_SENT;
---- 7． 用一个指向MapiRecipDesc结构的指针设置发送者信息（lpOriginator），或将其设置为NULL：
message.lpOriginator = NULL;
---- 8． 设置接收者数目（nRecipCount），可以是1或更多：
message.nRecipCount = 1;
---- 9． 设置接收者信息（lpRecips），详见3-3-2节
---- 10． 设置附件数量（nFileCount）
---- 11． 设置附件信息，详见3-3-3节
b3-3-2 正确设置接收者信息
---- 设置接收者信息时，应当使用MAPIResolveName函数来为MapiRecipDesc结构对象分配内存，并返回一个指针，该指针将被保存在MapiMessage结构的lpRecips中。MAPIResolveName的函数声明如下：
ULONG FAR PASCAL MAPIResolveName(LHANDLE lhSession,
ULONG ulUIParam, LPTSTR lpszName,
FLAGS flFlags, ULONG ulReserved,
lpMapiRecipDesc FAR * lppRecip )
---- 其中lppRecip即为前面提到的返回的指针。除flFlags外其余参数与前几个函数意义相同。flFlags的值详见表5。
表5：MAPIResolveName中flFlags的值
值 意义
MAPI_AB_NOMODIFY 对话框为只读。如果MAPI_DIALOG被设置，
那么该项将被忽略。
MAPI_DIALOG 显示一个名称解决方案的对话框
MAPI_LOGON_UI 如果需要的话，将会显示仪个对话框让用户登录
MAPI_NEW_SESSION 新建一个会话
程序示例：
char recipient[512];
strcpy(recipient, sTo);
lResult = lpfnMAPIResolveName(lhSession, 0, recipient,
0, 0, &message.lpRecips);
3-3-3 添加附件
---- 下面的程序示例将演示如何在电子邮件中包含附件。只有一点需要说明：MapiFileDesc结构中flFlags的值，详见表6。
表6：MapiFileDesc结构中flFlags的值
值 意义
MAPI_OLE 附件是OLE对象。
MAPI_OLE_STATIC 附件是静态OLE对象。
0 附件将被视为数据文件
程序示例：
// 设置附件信息
CString sPath, sFileName;
MapiFileDesc FileInfo;
char path[512];
char filename[512];
if (sAttachment == “”)
message.nFileCount = 0;
else
{
int nPos = sAttachment.ReverseFind(‘//’);
if (nPos == -1)
{
sPath = sAttachment;
}
else
{
sPath = sAttachment;
sFilename = sAttachment.Mid(nPos +1);
}
strcpy(path, sPath);
strcpy(filename, sFilename);
message.nFileCount = 1;
FileInfo.ulReserved = 0;
FileInfo.flFlags = 0;
FileInfo.nPosition = sMessage.GetLength() –1;
FileInfo.lpszPathName = path;
FileInfo.lpszFileName = filename;
FileInfo.lpFileType = NULL;
message.lpFiles = & m_FileInfo;
}
3-3-4 发送电子邮件
---- 使用MAPISendMail发送电子邮件，其声明如下：
ULONG FAR PASCAL MAPISendMail (LHANDLE lhSession,
ULONG ulUIParam, lpMapiMessage lpMessage,
FLAGS flFlags, ULONG ulReserved )
---- 其中，flFlags的允许值为MAPI_DIALOG、MAPI_LOGON_UI和MAPI_NEW_SESSION，其意义与前几个函数中同名标识意义相同。
程序示例：
lResult = lpfnMAPISendMail(0, 0, &m_message, 0, 0);
3-3-5 释放内存
程序示例：
lpfnMAPIFreeBuffer(m_message.lpRecips);
四、小结
---- 本文比较具体的介绍并演示了编写一个电子邮件程序的核心部分，如果读者要编写电子邮件程序，还需要进行的处理：
---- 1． 加上错误处理代码。受篇幅限制，本文的程序示例中只有两处为错误处理留空，比较它们的异同。电子邮件程序是非常容易出错的，因此除这两处外要在主要函数调用完成后都加上错误处理，或使用try throw catch块处理例外。
---- 2． 加上UI处理。
---- 另外，本文所阐述的方法比较简单易行，事实上，有关电子邮件的程序远比这复杂得多，因此读者若需要编写一个功能强大的电子邮件程序，需要精通MAPI和SMTP/POP3等协议；如果读者要编写一个电子邮件服务器，那么不妨在精通MAPI和SMTP/POP3之后，阅读一些有关Exchange Server的资料。
说明：本教程来源互联网或网友上传或出版商，仅为学习研究或媒体推广，wanshiok.com不保证资料的完整性。
2/2 首页 上一页 1 2 |
