ITableData : IUnknown
适用于:Outlook 2013 | Outlook 2016
提供用于处理表的实用工具方法。 MAPI 提供表数据对象或实现 ITableData 的对象,以帮助服务提供商执行表维护。 若要获取表数据对象,服务提供程序调用 CreateTable 函数。
属性 | 值 |
---|---|
标头文件: |
Mapiutil.h |
公开者: |
表数据对象 |
实现者: |
MAPI |
调用者: |
服务提供程序 |
接口标识符: |
IID_IMAPITableData |
指针类型: |
LPTABLEDATA |
Vtable 顺序
成员 | 说明 |
---|---|
HrGetView |
创建表视图,返回指向 IMAPITable 实现的指针。 |
HrModifyRow |
插入新的表行,可能替换现有行。 |
HrDeleteRow |
删除表行。 |
HrQueryRow |
检索表行。 |
HrEnumRow |
根据行在表中的位置检索行。 |
HrNotify |
发送表行的通知。 |
HrInsertRow |
插入表格行。 |
HrModifyRows |
插入多个表行,可能替换现有行。 |
HrDeleteRows |
删除多个表行。 |
备注
ITableData 的 MAPI 实现通过保留所有数据和内存中的任何相关限制来处理表,使其不适合用于非常大的表。 不支持大型限制和复杂操作(例如分类)。
表数据对象使用索引列标识行,索引列是保证每行具有唯一值的属性。 大多数服务提供商使用 PR_INSTANCE_KEY (PidTagInstanceKey) 属性作为索引列。 具有多个值的属性不能用作索引列。
无论受更改或删除影响的行数如何,表数据对象都会生成单个通知。 如果操作中的目标行不存在,则会添加一行。