PidTagRecordKey 规范属性

适用于:Outlook 2013 | Outlook 2016

包含特定对象的唯一二进制比较标识符。

属性
相关属性:
PR_RECORD_KEY
标识符:
0x0FF9
数据类型:
PT_BINARY
区域:
ID 属性

备注

此属性便于查找对对象的引用,如在内容表中查找其行。 此属性不能用于打开对象;将条目标识符用于该目的。

附件子对象应在邮件中通过此属性进行唯一标识。 此标识符是唯一保证在关闭并重新打开邮件后保持不变的附件特征。 存储提供程序必须跨会话保留此属性以确保此保证。

对于文件夹,此属性包含文件夹层次结构表中使用的键。 通常,此值与 PidTagEntryId PR_ENTRYID (提供的值) 相同。

对于邮件存储,此属性与 PidTagStoreRecordKey PR_STORE_RECORD_KEY (属性) 相同。

在邮件存储对象中,此属性在所有存储提供程序中应是唯一的。 实现此目标的方法之一是,将存储 PR_MDB_PROVIDER ( PidTagStoreProvider) (属性的值(特定于该提供程序类型) )与 GUID 结构或其他特定于特定邮件存储的值组合在一起。

首次调用 IMAPIProp::SaveChanges 方法后,此属性始终可以通过 IMAPIProp::GetProps 方法使用。 一些提供程序可以在实例化后立即提供。

客户端或服务提供商可以使用 memcmp 比较此属性的值。 条目标识符值不能这样做。 但是,此属性保证在同一邮件存储或通讯簿容器中是唯一的;不同容器中的两个对象可以具有相同的此属性的值。

记录和搜索键之间的一个区别是记录键特定于对象,而搜索键可以复制到其他对象。 例如,该对象的两个副本的 PidTagSearchKey PR_SEARCH_KEY (PidTagSearchKey) 值相同,但此属性必须具有不同的值。

下表汇总了 PidTagSearchKey PR_ENTRYID、PR_SEARCH_KEY (PidTagSearchKey) 和此属性之间的重要差异。

特征 PR_ENTRYID PR_RECORD_KEY PR_SEARCH_KEY
附件对象上必需



文件夹对象上必需



在邮件存储对象上是必需的



状态对象上必需



按客户端创建



在调用 SaveChanges 之前可用
也许
也许
消息是其他可能
复制操作中已更改



复制后客户端可更改



在 ... 中是唯一的 整个世界
提供程序实例
整个世界
与 memcmp (类似的二进制)
否 -- 使用 IMAPISupport:: CompareEntryIDs


协议规范

[MS-OXPROPS]

提供对相关协议Exchange Server的引用。

[MS-OXCMSG]

处理邮件和附件对象。

[MS-OXOABK]

指定用户、联系人、组和资源的列表的属性和操作。

头文件

Mapidefs.h

提供数据类型定义。

Mapitags.h

包含作为备用名称列出的属性的定义。

另请参阅

MAPI 属性

MAPI 规范属性

将规范属性名称映射到 MAPI 名称

将 MAPI 名称映射到规范属性名称