用Visual C++编写电子邮件程序(二)

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的资料。