PidTagSearchKey 规范属性

适用于:Outlook 2013 | Outlook 2016

包含二进制比较键,用于标识搜索的相关对象。

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

备注

此属性提供相关对象(如邮件副本)的跟踪,并便于查找不需要的事件,如重复的收件人。

MAPI 使用特定规则来构造邮件收件人的搜索键。 搜索键通过连接地址类型 ((大写字符) 、冒号字符":"、规范形式的电子邮件地址和终止 null 字符)而形成。 此处的规范形式意味着正确大小写显示区分大小写的地址,不区分大小写的地址将转换为大写。 这一点对于保留邮件之间的关联很重要。

对于 message 对象,此属性可在创建邮件后立即通过 IMAPIProp::GetProps 方法使用。 对于其他对象,在首次调用 IMAPIProp::SaveChanges 方法后可用。 由于此属性是可更改的,因此在 SaveChanges 调用提交 IMAPIProp::SetProps 方法设置或更改的任何值之前,通过 GetProps 获取此属性是不可靠的。

对于配置文件,MAPI 还提供一个名为 MUID_PROFILE_INSTANCE 的硬编码配置文件节,将此属性用作其单个属性。 该密钥保证在以前创建的所有配置文件中是唯一的,并且比 PR_PROFILE_NAME (PidTagProfileName) 属性更可靠,例如,可以使用相同的名称删除和重新创建该属性。

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

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



文件夹对象上必需



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



状态对象上必需



按客户端创建



SaveChanges 之前可用
取决于提供程序实现
取决于提供程序实现
对于邮件,是。 对于其他人,它依赖于提供程序实现。
复制操作中已更改



复制后客户端可更改



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


协议规范

[MS-OXPROPS]

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

[MS-OXCMSG]

处理邮件和附件对象。

[MS-OXOABK]

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

头文件

Mapidefs.h

提供数据类型定义。

Mapitags.h

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

另请参阅

PidTagResponsibility 规范属性

PidTagStoreRecordKey 规范属性

MAPI 属性

MAPI 规范属性

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

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