通讯簿限制

适用于:Outlook 2013 | Outlook 2016

通讯簿提供商需要支持对其容器的内容表的三种类型的限制:

  • 不明确的名称属性限制

  • 实例密钥属性限制

  • 带前缀的显示名称内容限制

不明确的名称限制是使用 PR_ANR (PidTagAnr) 属性将收件人姓名与通讯簿容器中的条目匹配的属性限制。 PR_ANR属性限制是一种“最佳猜测”搜索类型,通过此搜索,通讯簿提供程序可以选择最适合其容器的匹配属性。 例如,一个通讯簿提供程序可能通过将收件人姓名与每个容器条目的 PR_ACCOUNT (PidTagAccount) 属性进行匹配来实现PR_ANR限制,而另一个通讯簿提供程序可能会使用 PR_DISPLAY_NAME (PidTagDisplayName) 。

MAPI 建议 PR_ANR 限制的实现在适当的性能和用户满意度之间取得平衡。 当通讯簿提供商以找到的匹配项太少或太多的方式实施限制时,用户满意度可能会受到损害。 某些通讯簿提供程序支持在对话框中无法显示但可以匹配不明确名称限制的可分辨或通用名称。

典型的实现可能是将收件人的显示名称分析为单词,与包含所有字词的任何条目匹配。 注意详细信息,例如对单词位置的敏感度、是否匹配非连续单词以及分隔符的选择可能会有所不同。 例如,如果要解析的名称为“Bill L”,则典型的 PR_ANR 限制会选择以下条目作为匹配项:

  • Billy Larson

  • 比尔·李

  • 小比尔·洛根

  • 山姆·比尔·李

实例键限制或 PR_INSTANCE_KEY (PidTagInstanceKey) 属性限制,用于实现客户端应用程序中用于查看 MAPI 表的列表框。 某些列表框实现允许用户进行多项选择、向上或向下滚动,并返回到所选的第一项。 为了实现此行为,客户端调用 IMAPITable::FindRow,将 PR_INSTANCE_KEY 属性的属性限制传递给 方法。 通讯簿提供商必须支持此限制。

用于表查看的列表框的另一个功能是能够基于一组前缀字符定位光标。 当用户开始键入前缀字符时,客户端会将光标移动到以这些字符开头的第一项。 客户端通过基于 PR_DISPLAY_NAME 属性和 FL_PREFIX 模糊级别的内容限制来实现此功能。

另请参阅

MAPI 表