MAPI 属性概述

适用于:Outlook 2013 | Outlook 2016

属性是 MAPI 对象的属性。 属性描述有关对象的内容,例如消息的主题行或消息用户的地址类型。 MAPI 定义许多属性,其中一些用于描述许多对象,有些属性仅适用于特定类型的对象。 客户端和服务提供商可以通过创建新的自定义属性来扩展 MAPI 的预定义属性集。 客户端可以定义属性来描述新的消息类,服务提供程序可以定义属性来公开其消息系统的独特功能。

属性可以是永久性的,也可以是临时的。 从会话保存到会话的属性可以与其对象的数据一起存储,也可以存储在配置文件中。 临时属性仅在当前会话期间存在。

客户端和服务提供商可以使用表或属性表向用户显示属性。 表为用户提供属于多个对象的某些属性的只读视图。 数据以行和列格式显示,每行表示对象,每列表示属性。 属性表是选项卡式对话框,显示单个对象的相关属性。 属性表可以提供对数据的只读或读/写访问权限。 是否允许用户进行更改由属性表的实现者决定。

IMAPIProp 接口是处理属性的主要接口。 支持属性的所有对象都实现 IMAPIPropIMAPIProp 包括用于检索属性值、复制属性、进行更改和保存这些更改、在属性名称及其标识符之间进行映射以及检索有关先前错误的信息的方法。

有多种数据结构用于描述属性和有关属性的信息。 最常用的结构是 SPropValue 结构和 SPropTagArray 结构。 SPropValue 结构包含描述属性的三条信息:

  • 属性的数据或值。

  • 属性值的数据类型,例如整数或布尔值。

  • 特定范围内的数值,用于唯一标识负责维护它的属性和组件。 例如,有一个范围用于保存 MAPI 定义的消息内容属性,另一个区域用于保存客户端为自定义消息类定义的消息内容属性。

属性类型和标识符合并到名为 属性标记的单个组件中。 属性标记是可用于轻松引用 属性的常量。 MAPI 定义的属性的属性标记包含在 MAPITAGS 中。H 头文件和 SPropValue 结构的 ulPropTag 成员中。 客户端和服务提供商使用属性标记来标识、检索和更新相应的属性。

SPropTagArray 结构是属性标记的计数数组。 IMAPIProp 和其他接口中的许多方法都使用 SPropTagArray 结构来描述属性。

另请参阅

MAPI 概念