PropVariantCompareEx 函式 (propvarutil.h)

發行項
03/05/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 轉換成 propvar1 的 vartype，然後再加以比較。

注意此函式的行為，因此傳回的結果可以從發行變更為發行。它不應該用於標準排序應用程式。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 SP1 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	propvarutil.h
程式庫	Propsys.lib
Dll	Propsys.dll (6.0 版或更新版本)
可轉散發套件	Windows 桌面搜尋 (WDS) 3.0

共用方式為