FPropContainsProp
Область применения: Outlook 2013 | Outlook 2016
Сравнивает два значения свойств, как правило, строки или двоичные массивы, чтобы узнать, содержит ли одно из них другое.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapiutil.h |
| Реализовано в: |
MAPI |
| Вызывающая сторона: |
Клиентские приложения и поставщики услуг |
BOOL FPropContainsProp(
LPSPropValue lpSPropValueDst,
LPSPropValue lpSPropValueSrc,
ULONG ulFuzzyLevel
);
Параметры
lpSPropValueDst
[в] Указатель на структуру SPropValue , определяющую значение свойства, которое может содержать строку поиска, на которую указывает параметр lpSPropValueSrc .
lpSPropValueSrc
[в] Указатель на структуру SPropValue , определяющую строку поиска , которую ищет FPropContainsProp , в значении свойства, на которое указывает параметр lpSPropValueDst .
ulFuzzyLevel
[в] Параметры параметров, определяющие уровень точности, используемый при сравнении.
Нижние 16 бит применяются к свойствам типа PT_BINARY и PT_STRING8. Для них должно быть задано одно из следующих значений:
FL_FULLSTRING. Строка поиска lpSPropValueSrc должна быть равна значению свойства, определенному lpSPropValueDst.
FL_PREFIX. Строка поиска lpSPropValueSrc должна отображаться в начале значения свойства, определяемого lpSPropValueDst. Эти два значения следует сравнивать только до длины строки поиска, указанной lpSPropValueSrc.
FL_SUBSTRING. Строка поиска lpSPropValueSrc должна содержаться в любом месте в значении свойства, определяемом lpSPropValueDst.
Верхние 16 бит применяются только к свойствам типа PT_STRING8. Для них можно задать следующие значения в любой комбинации:
FL_IGNORECASE. Сравнение должно выполняться без учета учета регистра.
FL_IGNORENONSPACE. Сравнение должно игнорировать символы, не определяемые Юникодом, такие как диакритические знаки.
FL_LOOSE. Сравнение должно по возможности указывать на совпадение, игнорируя чувствительность регистра и символы без учета.
Возвращаемое значение
TRUE
Все параметры допустимы, и строка поиска lpSPropValueSrc содержится, как указано в значении свойства lpSPropValueDst .
FALSE
Сравниваемые значения свойств не относятся к типу PT_STRING8 или PT_BINARY, значения свойств имеют разные типы или строка поиска lpSPropValueSrc не содержится, как указано в значении свойства lpSPropValueDst .
Замечания
Метод сравнения зависит от типов свойств, указанных в определениях свойств SPropValue , и эвристики нечеткого уровня, предоставленной в параметре ulFuzzyLevel . Функции FPropCompareProp и FPropContainsProp можно использовать для подготовки ограничений для создания таблицы.
Верхние 16 бит ulFuzzyLevel игнорируются для типа свойства PT_BINARY. Если параметры в ulFuzzyLevel отсутствуют или недопустимы, выполняется полное соответствие строк. Дополнительные сведения о свойстве containment см. в разделе Структура SContentRestriction .