MAPIMessages 控件

消息应用程序接口 (MAPI) 控件允许创建邮件功能的 Visual Basic MAPI 应用程序。有 2 个 MAPI 控件：

• MAPISession
  
  
• MAPIMessages

MAPISession 控件启动并建立一 MAPI 会话。它也用于结束 MAPI 会话。MAPIMessages 控件允许用户执行各种消息系统功能。

MAPI 控件在运行时是不可见的。而且，对该控件不存在事件。为使用它们，必须指定适当的方法。

在用 MAPIMessages 控件建立一个消息会话后，MAPISession 控件可以执行各种消息系统功能。

为使这些控件正常工作，必须提供 MAPI 服务。MAPI 服务是符合电子邮件系统规范的。

注意 如果试图运行一个使用 MAPI 控件的程序，要确保已正确安装了 32 位 MAPI DDL，否则将不能执行象 SignOn 这样简单的 MAPI 功能。例如在 Windows 95 上，在操作系统设置期间必须安装 MAIL、或者从控制面板上单独地安装 MAIL，以正确使用 visual basic 的 MAPI 功能或 MAPI 自定义控件。

语法

MAPIMessages

说明

使用 MAPIMessages 控件可以：

• 访问当前收件箱中的消息。
  
  
• 构成一条新消息。
  
  
• 添加及删除消息收件人和附件。
  
  
• 发送消息（无论有无支持的用户接口）。
  
  
• 保存、复制、和删除消息。
  
  
• 显示“通讯簿”对话框。
  
  
• 显示“详细资料”对话框。
  
  
• 访问附件，包括对件连接和嵌入 (OLE) 附件。
  
  
• 在寻址过程中，分析一个收件人的名字。
  
  
• 对消息执行应答，全应答和转发操作。

MAPIMessages 控件的大部分属性可分到 4 个功能区：通讯簿、文件附件、消息和收件人属性。文件附件、消息和收件人属性分别有 AttachmentIndex，MsgIndex 和 RecipIndex 属性控制。

消息缓冲区

当使用 MAPIMessages 控件时，需跟踪 2 个缓冲区：构成缓冲区和读缓冲区。读缓冲区由取自用户的收件箱的一个可索引的消息集合组成。MsgIndex 属性用于访问该集合单个消息，第一个消息的 MsgIndex 属性为 0，以后的消息依次加 1，直至集合的尾部。

消息集使用 Fetch 方法建立。该消息集包括 FetchMsgType 类型的所有消息，并且按FetchSorted 属性的规定进行分类。先前读的消息可以包括在有 FetchUnreadOnly 属性的消息集之内，或留在集合外。用户不能修改读缓冲区中的消息，但可以将消息拷贝到构成缓冲区中进行修改。

在构成缓冲区中可以创建和编辑消息。当 MsgIndex 属性值为 -1 时，构成缓冲区是活动缓冲区。许多对消息的操作只有在构成缓冲区中才是有效的，例如发送消息，用对话框发送消息，保存消息，或删除收件人和附件。

要想了解用于控件的属性和错误常量请参阅“对象浏览器”中的对象库。