SRestriction
Gilt für: Outlook 2013 | Outlook 2016
Beschreibt einen Filter zum Einschränken der Ansicht einer Tabelle auf bestimmte Zeilen.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
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
Rt
Der Einschränkungstyp. Folgende Werte sind möglich:
RES_AND
Eine AND-Einschränkung , die eine bitweise AND-Operation auf eine Einschränkung anwendet.
RES_BITMASK
Eine Bitmaskeneinschränkung, die eine Bitmaske auf einen Eigenschaftswert anwendet.
RES_COMMENT
Eine Kommentareinschränkung, die einen Kommentar einer Einschränkung zuordnet.
RES_COMPAREPROPS
Eine Eigenschaftsvergleichseinschränkung, die zwei Eigenschaftswerte vergleicht.
RES_CONTENT
Eine Inhaltseinschränkung, die einen Eigenschaftswert nach bestimmten Inhalten durchsucht.
RES_EXIST
Eine Exist-Einschränkung, die bestimmt, ob eine Eigenschaft unterstützt wird.
RES_NOT
Eine NOT-Einschränkung , die einen logischen NOT-Vorgang auf eine Einschränkung anwendet.
RES_OR
Eine OR-Einschränkung , die einen logischen OR-Vorgang auf eine Einschränkung anwendet.
RES_PROPERTY
Eine Eigenschaftseinschränkung, die bestimmt, ob ein Eigenschaftswert mit einem bestimmten Wert übereinstimmt.
RES_SIZE
Eine Größeneinschränkung, die bestimmt, ob ein Eigenschaftswert eine bestimmte Größe ist.
RES_SUBRESTRICTION
Eine Unterobjekteinschränkung, die eine Einschränkung auf die Anlagen oder Empfänger einer Nachricht anwendet.
res
Vereinigung von Einschränkungsstrukturen, die den anzuwendenden Filter beschreiben. Die spezifische Struktur, die im res-Element enthalten ist, hängt vom Wert des rt-Elements ab. Die Zuordnung zwischen Einschränkungstyp und -struktur ist in der folgenden Tabelle aufgeführt.
| Eigenschaft | Wert |
|---|---|
| Einschränkungstyp |
Einschränkungsstruktur |
| 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 |
Hinweise
Clients verwenden eine SRestriction-Struktur , um die Anzahl und den Typ der Zeilen in ihrer Ansicht einer Tabelle zu begrenzen und nach bestimmten Nachrichten in einem Ordner zu suchen. Um die Einschränkung für eine Tabelle zu erzwingen, rufen Clients entweder IMAPITable::Restrict oder IMAPITable::FindRow auf. Um die Einschränkung für einen Ordner zu erzwingen, rufen Clients die IMAPIContainer::SetSearchCriteria-Methode des Ordners auf.
Informationen zur Verwendung von Einschränkungen mit Tabellen finden Sie unter Informationen zu Einschränkungen.