SRestriction

项目
04/04/2023

适用于：Outlook 2013 | Outlook 2016

描述用于将表视图限制为特定行的筛选器。

属性	值
标头文件：	Mapidefs.h

typedef struct _SRestriction
{
  ULONG rt;
  union
  {
    SComparePropsRestriction resCompareProps;
    SAndRestriction resAnd;
    SOrRestriction resOr;
    SNotRestriction resNot;
    SContentRestriction resContent;
    SPropertyRestriction resProperty;
    SBitMaskRestriction resBitMask;
    SSizeRestriction resSize;
    SExistRestriction resExist;
    SSubRestriction resSub;
    SCommentRestriction resComment;
  } res;
} SRestriction;

Members

限制类型。可能的值如下所示：

RES_AND

AND 限制，将按位 AND 操作应用于限制。

RES_BITMASK

位掩码限制，它将位掩码应用于属性值。

RES_COMMENT

注释限制，将注释与限制相关联。

RES_COMPAREPROPS

属性比较限制，用于比较两个属性值。

RES_CONTENT

内容限制，用于搜索特定内容的属性值。

RES_EXIST

存在限制，用于确定是否支持属性。

RES_NOT

非限制，它将逻辑 NOT 操作应用于限制。

RES_OR

OR 限制，将逻辑 OR 操作应用于限制。

RES_PROPERTY

属性限制，用于确定属性值是否与特定值匹配。

RES_SIZE

大小限制，用于确定属性值是否为特定大小。

RES_SUBRESTRICTION

子对象限制，将限制应用于邮件的附件或收件人。

res

描述要应用的筛选器的限制结构的并集。 res 成员中包含的特定结构取决于 rt 成员的值。下表列出了限制类型和结构之间的映射。

属性	值
限制类型	限制结构
RES_AND	SAndRestriction
RES_BITMASK	SBitMaskRestriction
RES_COMMENT	SCommentRestriction
RES_COMPAREPROPS	SComparePropsRestriction
RES_CONTENT	SContentRestriction
RES_EXIST	SExistRestriction
RES_NOT	SNotRestriction
RES_OR	SOrRestriction
RES_PROPERTY	SPropertyRestriction
RES_SIZE	SSizeRestriction
RES_SUBRESTRICTION	SSubRestriction

备注

客户端使用 SRestriction 结构来限制表视图中的行数和行类型，并搜索文件夹中的特定邮件。若要对表施加限制，客户端调用 IMAPITable：：Restrict 或 IMAPITable：：FindRow。若要对文件夹施加限制，客户端调用文件夹的 IMAPIContainer：：SetSearchCriteria 方法。

有关如何对表使用限制的信息，请参阅关于限制。