Partager via

LPropCompareProp

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Compare deux valeurs de propriété pour déterminer si elles sont égales.

Propriété Valeur
Fichier d’en-tête :
 Mapiutil.h
Implémenté par :
 MAPI
Appelé par :
 Applications clientes et fournisseurs de services
 
LONG LPropCompareProp(
  LPSPropValue lpSPropValueA,
  LPSPropValue lpSPropValueB
);

Paramètres

lpSPropValueA

[in] Pointeur vers une structure SPropValue définissant la première valeur de propriété à comparer.

lpSPropValueB

[in] Pointeur vers une structure SPropValue définissant la deuxième valeur de propriété à comparer.

Valeur renvoyée

LPropCompareProp retourne l’une des valeurs suivantes pour la plupart des types de propriétés :

  • Inférieur à zéro si la valeur indiquée par le paramètre lpSPropValueA est inférieure à celle indiquée par le paramètre lpSPropValueB .

  • Supérieur à zéro si la valeur indiquée par lpSPropValueA est supérieure à celle indiquée par lpSPropValueB.

  • Zéro si la valeur indiquée par lpSPropValueA est égale à la valeur indiquée par lpSPropValueB.

Pour les types de propriétés qui n’ont pas de classement intrinsèque, tels que les types booléens ou d’erreur, la fonction LPropCompareProp retourne une valeur non définie si les deux valeurs de propriété ne sont pas égales. Cette valeur non définie est différente de zéro et cohérente entre les appels.

Remarques

Utilisez la fonction LPropCompareProp uniquement si les types des deux propriétés à comparer sont identiques.

Avant d’appeler LPropCompareProp, une application cliente ou un fournisseur de services doit d’abord récupérer les propriétés à des fins de comparaison avec un appel à la méthode IMAPIProp ::GetProps . Lorsqu’un client ou un fournisseur appelle LPropCompareProp, la fonction examine d’abord les balises de propriété pour s’assurer que la comparaison des valeurs de propriété est valide. La fonction compare ensuite les valeurs de propriété, en retournant une valeur appropriée.

Si les valeurs de propriété sont inégales, LPropCompareProp détermine celle qui est la plus élevée. Les propriétés que LPropCompareProp compare ne doivent pas appartenir au même objet.