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 , которое применяет логическую операцию NOT к ограничению.

RES_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 папки.

Сведения об использовании ограничений с таблицами см. в разделе Об ограничениях.