PropVariantCompareEx 関数 (propvarutil.h)

[アーティクル]
03/05/2024

指定した比較単位とフラグに基づいて、呼び出し元が 2 つの 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

2 番目の PROPVARIANT 構造体への参照。

[in] unit

種類: PROPVAR_COMPARE_UNIT

必要に応じて、PROPVAR_COMPARE_UNITで定義されている比較単位の 1 つを指定します。

[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
Library	Propsys.lib
[DLL]	Propsys.dll (バージョン 6.0 以降)
再頒布可能パッケージ	Windows デスクトップ検索 (WDS) 3.0

次の方法で共有