短期条目标识符

适用于:Outlook 2013 | Outlook 2016

当标识符必须快速构造且不需要持续一段时间或距离时,服务提供程序会将短期条目标识符分配给对象。 短期条目标识符的唯一性仅在当前工作站上的当前会话的生命周期内得到保证。 通常,短期条目标识符仅在释放它表示的对象之前有效。

短期条目标识符分配给表中的行和对话框中的条目,其中需要快速提供浏览数据。 例如,邮件存储提供程序将短期条目标识符分配给内容表中的邮件行和收件人表中的收件人。

客户端可以使用这些短期条目标识符打开由表行表示的对象。 但是,与可与任何 OpenEntry 方法一起使用的长期条目标识符不同,短期条目标识符应与容器的 OpenEntry 方法一起使用。

实现短期条目标识符

实现短期条目标识符的最常见方法包括:

  • 使短期条目标识符与长期标识符相同,使所有标志保持未设置状态。

  • 使短期条目标识符与长期标识符不同,并设置所有标志。

客户端可以通过检查其 abFlags 成员来识别第二种类型的短期条目标识符,如下所示:

abFlags[0] = 0xFF;
 

某些服务提供商清除一个或多个标志,以创建有效期更高的短期条目标识符。 例如,以下 abFlags 成员表示可用于多天或多个会话的短期条目标识符:

abFlags[0] = 0xFF & ~MAPI_NOW;
abFlags[0] = 0xFF & ~MAPI_THISSESSION;
 

客户端可快速获取、使用和放弃短期条目标识符。 在大多数情况下,可以采用与长期条目标识符相同的方式使用它们。 可以从表中检索它们,将其传递给 OpenEntry 方法,并与 CompareEntryIDs 方法进行比较。 一个例外是它们永远不会从 IMAPIProp::GetProps 方法返回。 从 GetProps 返回的属性始终是长期条目标识符。

另请参阅