LPropCompareProp

Область применения: Outlook 2013 | Outlook 2016

Сравнивает два значения свойств, чтобы определить, равны ли они.

Свойство	Значение
Файл заголовка:	Mapiutil.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения и поставщики услуг

LONG LPropCompareProp(
  LPSPropValue lpSPropValueA,
  LPSPropValue lpSPropValueB
);

Параметры

lpSPropValueA

[в] Указатель на структуру SPropValue , определяющую первое сравниваемое значение свойства.

lpSPropValueB

[в] Указатель на структуру SPropValue , определяющую второе сравниваемое значение свойства.

Возвращаемое значение

LPropCompareProp возвращает одно из следующих значений для большинства типов свойств:

• Меньше нуля, если значение, указанное параметром lpSPropValueA , меньше значения, указанного параметром lpSPropValueB .

• Больше нуля, если значение, указанное lpSPropValueA , больше, чем указано lpSPropValueB.

• Ноль, если значение, указанное lpSPropValueA , равно значению, указанному lpSPropValueB.

Для типов свойств, не имеющих встроенного упорядочения, таких как логические типы или типы ошибок, функция LPropCompareProp возвращает неопределенное значение, если два значения свойства не равны. Это неопределенное значение является ненулевым и согласованным в разных вызовах.

Замечания

Используйте функцию LPropCompareProp, только если типы двух сравниваемых свойств одинаковы.

Перед вызовом LPropCompareProp клиентское приложение или поставщик служб должны сначала получить свойства для сравнения с вызовом метода IMAPIProp::GetProps . Когда клиент или поставщик вызывает LPropCompareProp, функция сначала проверяет теги свойств, чтобы убедиться, что сравнение значений свойств является допустимым. Затем функция сравнивает значения свойств, возвращая соответствующее значение.

Если значения свойств неравны, LPropCompareProp определяет, какое из них больше. Свойства, сравниваемые LPropCompareProp , не должны принадлежать одному и тому же объекту.