PidTagSearchKey 规范属性
适用于：Outlook 2013 | Outlook 2016
包含一个二进制可比较键，用于标识搜索的相关对象。
| 属性 | 值 |
|---|---|
| 相关属性： |
PR_SEARCH_KEY |
| 标识符: |
0x300B |
| 数据类型： |
PT_BINARY |
| 区域： |
ID 属性 |
备注
此属性提供相关对象（如邮件副本）的跟踪，并有助于查找不需要的匹配项，例如重复收件人。
MAPI 使用特定规则来构造邮件收件人的搜索键。 搜索键是通过连接地址类型 (大写字符) 、冒号字符“：”、规范形式的电子邮件地址和终止 null 字符来构成的。 此处的规范形式表示区分大小写的地址以正确的大小写显示，不区分大小写的地址将转换为大写。 这在保留消息之间的相关性时非常重要。
对于消息对象，此属性在消息创建后立即通过 IMAPIProp：：GetProps 方法提供。 对于其他对象，在第一次调用 IMAPIProp：：SaveChanges 方法后，可以使用它。 由于此属性可更改，因此在 SaveChanges 调用提交 IMAPIProp：：SetProps 方法设置或更改的任何值之前，通过 GetProps 获取此属性是不可靠的。
对于配置文件，MAPI 还提供名为 MUID_PROFILE_INSTANCE 的硬编码配置文件部分，此属性作为其单个属性。 此密钥保证在创建的所有配置文件中是唯一的，并且比 PR_PROFILE_NAME (PidTagProfileName) 属性更可靠，例如，该属性可以删除并重新创建同名。
下表汇总了 pidTagEntryId) 、PR_RECORD_KEY (PidTagRecordKey) 和此属性之间的PR_ENTRYID ( 的重要差异。
| 特征 | PR_ENTRYID | PR_RECORD_KEY | PR_SEARCH_KEY |
|---|---|---|---|
| 附件对象上必需 |
否 |
是 |
否 |
| 对文件夹对象是必需的 |
是 |
是 |
否 |
| 消息存储对象上必需 |
是 |
是 |
否 |
| 状态对象上必需 |
是 |
否 |
否 |
| 可按客户端创建 |
否 |
否 |
是 |
|
在 SaveChanges 之前可用 |
取决于提供程序实现 |
取决于提供程序实现 |
对于消息，是。 对于其他人，这取决于提供程序实现。 |
| 在复制操作中更改 |
是 |
是 |
否 |
| 复制后可由客户端更改 |
否 |
否 |
是 |
| 在 ... 中唯一 | 整个世界 |
提供程序实例 |
整个世界 |
| 二进制可比 (与 memcmp) |
否 -- 使用 IMAPISupport：：CompareEntryIDs |
是 |
是 |
相关资源
协议规范
提供对相关Exchange Server协议规范的引用。
处理邮件和附件对象。
指定用户、联系人、组和资源列表的属性和操作。
头文件
Mapidefs.h
提供数据类型定义。
Mapitags.h
包含作为备用名称列出的属性的定义。