Partager via

FPropContainsProp

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Compare deux valeurs de propriété, généralement des chaînes ou des tableaux binaires, pour voir si l’une contient l’autre.

Propriété Valeur
Fichier d’en-tête :
 Mapiutil.h
Implémenté par :
 MAPI
Appelé par :
 Applications clientes et fournisseurs de services
 
BOOL FPropContainsProp(
  LPSPropValue lpSPropValueDst,
  LPSPropValue lpSPropValueSrc,
  ULONG ulFuzzyLevel
);

Paramètres

lpSPropValueDst

[in] Pointeur vers une structure SPropValue définissant la valeur de propriété pouvant contenir la chaîne de recherche pointée par le paramètre lpSPropValueSrc .

lpSPropValueSrc

[in] Pointeur vers une structure SPropValue définissant la chaîne de recherche recherchée par FPropContainsProp dans la valeur de propriété pointée par le paramètre lpSPropValueDst .

ulFuzzyLevel

[in] Paramètres d’option définissant le niveau de précision à utiliser dans la comparaison.

  • Les 16 bits inférieurs s’appliquent aux propriétés de type PT_BINARY et PT_STRING8. Elles doivent être définies sur l’une des valeurs suivantes :

    • FL_FULLSTRING : la chaîne de recherche lpSPropValueSrc doit être égale à la valeur de propriété identifiée par lpSPropValueDst.

    • FL_PREFIX : la chaîne de recherche lpSPropValueSrc doit apparaître au début de la valeur de propriété identifiée par lpSPropValueDst. Les deux valeurs doivent être comparées uniquement à la longueur de la chaîne de recherche indiquée par lpSPropValueSrc.

    • FL_SUBSTRING : la chaîne de recherche lpSPropValueSrc doit être contenue n’importe où dans la valeur de propriété identifiée par lpSPropValueDst.

  • Les 16 bits supérieurs s’appliquent uniquement aux propriétés de type PT_STRING8. Elles peuvent être définies sur les valeurs suivantes dans n’importe quelle combinaison :

    • FL_IGNORECASE : La comparaison doit être effectuée sans tenir compte du respect de la casse.

    • FL_IGNORENONSPACE : la comparaison doit ignorer les caractères non espacés définis par Unicode, tels que les signes diacritiques.

    • FL_LOOSE : la comparaison doit indiquer une correspondance dans la mesure du possible, en ignorant le respect de la casse et les caractères non espacés.

Valeur renvoyée

TRUE

Les paramètres sont tous valides et la chaîne de recherche lpSPropValueSrc est contenue comme spécifié dans la valeur de la propriété lpSPropValueDst .

FALSE

Les valeurs de propriété comparées ne sont pas de type PT_STRING8 ou PT_BINARY, les valeurs de propriété sont de types différents ou la chaîne de recherche lpSPropValueSrc n’est pas contenue comme spécifié dans la valeur de la propriété lpSPropValueDst .

Remarques

La méthode de comparaison dépend des types de propriétés spécifiés dans les définitions de propriété SPropValue et de l’heuristique de niveau flou fourni dans le paramètre ulFuzzyLevel . Les fonctions FPropCompareProp et FPropContainsProp peuvent être utilisées pour préparer des restrictions pour la génération d’une table.

Les 16 bits supérieurs de ulFuzzyLevel sont ignorés pour le type de propriété PT_BINARY. Si les paramètres de ulFuzzyLevel sont manquants ou non valides, une correspondance exacte de chaîne complète est effectuée. Pour plus d’informations sur l’autonomie des propriétés, consultez la structure SContentRestriction .