Freigeben über

LPropCompareProp

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Vergleicht zwei Eigenschaftswerte, um zu bestimmen, ob sie gleich sind.

Eigenschaft Wert
Headerdatei
 Mapiutil.h
Implementiert von:
 MAPI
Aufgerufen von:
 Clientanwendungen und Dienstanbieter
 
LONG LPropCompareProp(
  LPSPropValue lpSPropValueA,
  LPSPropValue lpSPropValueB
);

Parameter

lpSPropValueA

[in] Zeiger auf eine SPropValue-Struktur, die den ersten zu vergleichenden Eigenschaftswert definiert.

lpSPropValueB

[in] Zeiger auf eine SPropValue-Struktur, die den zweiten zu vergleichenden Eigenschaftswert definiert.

Rückgabewert

LPropCompareProp gibt einen der folgenden Werte für die meisten Eigenschaftentypen zurück:

  • Kleiner als 0 (null), wenn der durch den lpSPropValueA-Parameter angegebene Wert kleiner als der vom lpSPropValueB-Parameter angegebene Wert ist.

  • Größer als 0 (null), wenn der durch lpSPropValueA angegebene Wert größer als der durch lpSPropValueB angegebene Wert ist.

  • Null, wenn der durch lpSPropValueA angegebene Wert dem von lpSPropValueB angegebenen Wert entspricht.

Für Eigenschaftstypen, die keine systeminterne Reihenfolge aufweisen, z. B. boolesche Typen oder Fehlertypen, gibt die LPropCompareProp-Funktion einen nicht definierten Wert zurück, wenn die beiden Eigenschaftswerte ungleich sind. Dieser undefinierte Wert ist ungleich null und über Aufrufe hinweg konsistent.

Hinweise

Verwenden Sie die LPropCompareProp-Funktion nur, wenn die Typen der beiden zu vergleichenden Eigenschaften identisch sind.

Vor dem Aufrufen von LPropCompareProp muss eine Clientanwendung oder ein Dienstanbieter zuerst die Eigenschaften für den Vergleich mit einem Aufruf der IMAPIProp::GetProps-Methode abrufen. Wenn ein Client oder Anbieter LPropCompareProp aufruft, untersucht die Funktion zuerst die Eigenschaftstags, um sicherzustellen, dass der Vergleich der Eigenschaftswerte gültig ist. Die Funktion vergleicht dann die Eigenschaftswerte und gibt einen geeigneten Wert zurück.

Wenn die Eigenschaftswerte ungleich sind, bestimmt LPropCompareProp , welcher größer ist. Die Eigenschaften, die LPropCompareProp vergleicht, müssen nicht zum gleichen Objekt gehören.