PidTagRecordKey 规范属性

适用于:Outlook 2013 | Outlook 2016

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

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

备注

此属性有助于查找对对象的引用,例如在内容表中查找其行。 此属性不能用于打开对象;为此,请使用条目标识符。

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

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

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

在消息存储对象中,此属性在所有存储提供程序中应是唯一的。 执行此操作的一种方法是,将 PR_MDB_PROVIDER (PidTagStoreProvider) 属性的值组合在一起, (该提供程序类型) 具有 GUID 结构或特定消息存储区唯一的其他值。

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

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

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

下表汇总了 PR_ENTRYIDPR_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 名称映射到规范属性名称