SRestriction

Article
04/04/2023

S’applique à : Outlook 2013 | Outlook 2016

Décrit un filtre permettant de limiter l’affichage d’une table à des lignes particulières.

Propriété	Valeur
Fichier d’en-tête :	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

Type de restriction. Les valeurs possibles sont les suivantes :

RES_AND

Restriction AND , qui applique une opération AND au niveau du bit à une restriction.

RES_BITMASK

Restriction de masque de bits, qui applique un masque de bits à une valeur de propriété.

RES_COMMENT

Restriction de commentaire, qui associe un commentaire à une restriction.

RES_COMPAREPROPS

Restriction de comparaison de propriétés, qui compare deux valeurs de propriété.

RES_CONTENT

Restriction de contenu, qui recherche un contenu spécifique dans une valeur de propriété.

RES_EXIST

Restriction exist, qui détermine si une propriété est prise en charge.

RES_NOT

Restriction NOT , qui applique une opération NOT logique à une restriction.

RES_OR

Restriction OR , qui applique une opération OR logique à une restriction.

RES_PROPERTY

Restriction de propriété, qui détermine si une valeur de propriété correspond à une valeur particulière.

RES_SIZE

Restriction de taille, qui détermine si une valeur de propriété est une taille particulière.

RES_SUBRESTRICTION

Restriction de sous-objet, qui applique une restriction aux pièces jointes ou aux destinataires d’un message.

Res

Union de structures de restriction décrivant le filtre à appliquer. La structure spécifique incluse dans le membre res dépend de la valeur du membre rt . Le mappage entre le type de restriction et la structure est répertorié dans le tableau suivant.

Propriété	Valeur
Type de restriction	Structure de restriction
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

Remarques

Les clients utilisent une structure SRestriction pour limiter le nombre et le type de lignes dans leur vue d’une table et pour rechercher des messages spécifiques dans un dossier. Pour imposer la limitation à une table, les clients appellent IMAPITable ::Restrict ou IMAPITable ::FindRow. Pour imposer la limitation à un dossier, les clients appellent la méthode IMAPIContainer ::SetSearchCriteria du dossier.

Pour plus d’informations sur l’utilisation des restrictions avec des tables, consultez À propos des restrictions.