关于限制

适用于:Outlook 2013 | Outlook 2016

限制是一种将视图中的行数限制为仅具有符合特定条件的列值的行的方法。 对表使用限制有许多不同的机会。 客户端应用程序可以使用限制来筛选特定人员发送的邮件的目录,搜索不支持某个属性或已将属性设置为特定值的行,或者查找邮件中的重复收件人。

IMAPITable::RestrictIMAPITable::FindRow 方法用于对表设置限制。 Restrict 将限制应用于表而不检索任何行。 若要仅检索满足限制的行,需要对 IMAPITable::QueryRows 或类似方法进行后续调用。 FindRow 应用限制并检索表中与条件匹配的第一行。 FindRow 应用临时限制,该限制仅在调用期间存在,而 Restrict 应用更永久的限制。

某些客户端可以使用不在当前列集中的列来构建限制。 支持此类限制是可选的,支持此限制的表实现程序会增加价值,尤其是对于内容表。 不支持它的表实现者可以从 Restrict 调用返回MAPI_E_TOO_COMPLEX值,也可以从 FindRow 调用返回MAPI_E_NOT_FOUND值。

客户端应注意,即使提供程序确实支持对不在当前列集中的列的限制,它们也会通过通过 IMAPITable::SetColumns 指定要在其限制中使用的列来获得更好的整体性能。

另请参阅

MAPI 表