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_ENTRYID、 PR_SEARCH_KEY (PidTagSearchKey) 和此属性之间的重要差异。
特征 | PR_ENTRYID | PR_RECORD_KEY | PR_SEARCH_KEY |
---|---|---|---|
附件对象上必需 |
否 |
是 |
否 |
对文件夹对象是必需的 |
是 |
是 |
否 |
消息存储对象上必需 |
是 |
是 |
否 |
状态对象上必需 |
是 |
否 |
否 |
可按客户端创建 |
否 |
否 |
是 |
在调用 SaveChanges 之前可用 |
也许 |
也许 |
消息是其他也许 |
在复制操作中更改 |
是 |
是 |
否 |
复制后可由客户端更改 |
否 |
否 |
是 |
在 ... 中唯一 | 整个世界 |
提供程序实例 |
整个世界 |
二进制可比 (与 memcmp) |
否 -- 使用 IMAPISupport:: CompareEntryIDs |
是 |
是 |
相关资源
协议规范
提供对相关Exchange Server协议规范的引用。
处理邮件和附件对象。
指定用户、联系人、组和资源列表的属性和操作。
头文件
Mapidefs.h
提供数据类型定义。
Mapitags.h
包含作为备用名称列出的属性的定义。