从表行检索数据

适用于:Outlook 2013 | Outlook 2016

从表中检索行涉及:

  • 获取所有列的属性值。

  • 修改当前位置。

大多数表中的必需列之一是条目标识符( PR_ENTRYID (PidTagEntryId) 属性),可用于打开表示行的对象。 此条目标识符通常是短期条目标识符,不会在表的生存期内保留。 但是,如果实现表的服务提供商仅支持一种类型的条目标识符,则它可以是长期标识符。

客户端和服务提供商可以进行以下调用之一来检索行:

呼叫 说明
IMAPITable::QueryRows
在向前或向后方向检索从当前行开始的指定行数。
HrQueryAllRows
检索表中的所有行。
ITableData::HrQueryRow
根据其索引列的值检索表中的行。 PR_INSTANCE_KEY (PidTagInstanceKey) 通常是表的索引列。

当可选属性作为表中的列之一包含时,某些行可能具有列的有效值,而其他行可能没有。 列是否存在有效值取决于提供行信息的对象是否设置 属性。 根据 对象的实现,不存在的属性可以在表中表示为 PR_NULL (PidTagNull) 或任意值。 表的用户必须小心区分不存在且具有无意义值的属性和确实存在且具有有效值的属性。

另请参阅

MAPI 表