PropVariantCompareEx 函数 (propvarutil.h)

项目
03/04/2024

通过允许调用方根据指定的比较单位和标志比较两个 PROPVARIANT 结构来扩展 PropVariantCompare。

语法

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)

将空值或 null 值视为大于非空值。此值可以与任何其他值进行 OR。

PVCF_USESTRCMP (0x00000002)

比较字符串时，请使用 StrCmp。

PVCF_USESTRCMPC (0x00000004)

比较字符串时，请使用 StrCmpC。

PVCF_USESTRCMPI (0x00000008)

比较字符串时，请使用 StrCmpI。

PVCF_USESTRCMPIC (0x00000010)

比较字符串时，请使用 StrCmpIC。

返回值

类型： INT

如果 propvar1 大于 propvar2，则返回 1
如果 propvar1 等于 propvar2，则返回 0
如果 propvar1 小于 propvar2，则返回 -1

注解

此函数不会比较所有类型;目前只有所选类型是可比较的。

默认情况下，VT_NULL/VT_EMPTY/0 元素向量被视为小于任何其他 vartype。

如果 vartype 不同，此函数会尝试在比较 propvar2 之前将 propvar2 转换为 propvar1 的 vartype。

注意此函数的行为以及它返回的结果可能会因发布而更改。它不应用于规范排序应用程序。

要求

要求	值
最低受支持的客户端	Windows XP SP2、Windows Vista [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2003 SP1 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	propvarutil.h
Library	Propsys.lib
DLL	Propsys.dll (6.0 或更高版本)
可再发行组件	Windows 桌面搜索 (WDS) 3.0

通过