Поделиться через

Функция PropVariantCompareEx (propvarutil.h)

  • Статья

Расширяет PropVariantCompare , позволяя вызывающему объекту сравнивать две структуры PROPVARIANT на основе указанных единиц сравнения и флагов.

Синтаксис

PSSTDAPI_(int) PropVariantCompareEx(
  [in] REFPROPVARIANT        propvar1,
  [in] REFPROPVARIANT        propvar2,
  [in] PROPVAR_COMPARE_UNIT  unit,
  [in] PROPVAR_COMPARE_FLAGS flags
);

Параметры

[in] propvar1

Тип: REFPROPVARIANT

Ссылка на первую структуру PROPVARIANT .

[in] propvar2

Тип: REFPROPVARIANT

Ссылка на вторую структуру PROPVARIANT .

[in] unit

Тип: PROPVAR_COMPARE_UNIT

Указывает, где это уместно, одну из единиц сравнения, определенных в PROPVAR_COMPARE_UNIT.

[in] flags

Тип: PROPVAR_COMPARE_FLAGS

Указывает одно из следующих.

PVCF_DEFAULT (0x00000000)

При сравнении строк используйте StrCmpLogical.

PVCF_TREATEMPTYASGREATERTHAN (0x00000001)

Пустые или пустые значения считаются большими, чем непустые значения. Это значение может быть равно OR с любым другим значением.

PVCF_USESTRCMP (0x00000002)

При сравнении строк используйте StrCmp.

PVCF_USESTRCMPC (0x00000004)

При сравнении строк используйте StrCmpC.

PVCF_USESTRCMPI (0x00000008)

При сравнении строк используйте StrCmpI.

PVCF_USESTRCMPIC (0x00000010)

При сравнении строк используйте StrCmpIC.

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

Тип: INT

  • Возвращает значение 1, если propvar1 больше propvar2
  • Возвращает 0, если propvar1 равно propvar2
  • Возвращает значение -1, если значение propvar1 меньше propvar2

Комментарии

Эта функция сравнивает не все типы; В настоящее время сравниваются только выбранные типы.

По умолчанию векторы VT_NULL, VT_EMPTY и 0 элементов считаются меньшими, чем любой другой тип vartype.

Если vartypes отличаются, эта функция пытается преобразовать propvar2 в vartype propvar1 перед их сравнением.

Примечание Поведение этой функции и, следовательно, возвращаемых ею результатов, может изменяться от выпуска к выпуску. Его не следует использовать для канонических приложений сортировки.
 

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 с пакетом обновления 1 (SP1) [классические приложения | Приложения UWP]
Целевая платформа Windows
Header propvarutil.h
Библиотека Propsys.lib
DLL Propsys.dll (версия 6.0 или более поздняя)
Распространяемые компоненты Windows Desktop Search (WDS) 3.0