Fungsi PropVariantCompareEx (propvarutil.h)

Artikel
03/04/2024

Memperluas PropVariantCompare dengan memungkinkan pemanggil membandingkan dua struktur PROPVARIANT berdasarkan unit dan bendera perbandingan yang ditentukan.

Sintaks

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

Parameter

[in] propvar1

Jenis: REFPROPVARIANT

Referensi ke struktur PROPVARIANT pertama.

[in] propvar2

Jenis: REFPROPVARIANT

Referensi ke struktur PROPVARIANT kedua.

[in] unit

Jenis: PROPVAR_COMPARE_UNIT

Menentukan, jika sesuai, salah satu unit perbandingan yang ditentukan dalam PROPVAR_COMPARE_UNIT.

[in] flags

Jenis: PROPVAR_COMPARE_FLAGS

Tentukan salah satu hal berikut ini:

PVCF_DEFAULT (0x00000000)

Saat membandingkan string, gunakan StrCmpLogical.

PVCF_TREATEMPTYASGREATERTHAN (0x00000001)

Menganggap nilai kosong atau null lebih besar dari nilai yang tidak kosong. Nilai ini dapat di-OR-ed dengan nilai lain.

PVCF_USESTRCMP (0x00000002)

Saat membandingkan string, gunakan StrCmp.

PVCF_USESTRCMPC (0x00000004)

Saat membandingkan string, gunakan StrCmpC.

PVCF_USESTRCMPI (0x00000008)

Saat membandingkan string, gunakan StrCmpI.

PVCF_USESTRCMPIC (0x00000010)

Saat membandingkan string, gunakan StrCmpIC.

Nilai kembali

Jenis: INT

Mengembalikan 1 jika propvar1 lebih besar dari propvar2
Mengembalikan 0 jika propvar1 sama dengan propvar2
Mengembalikan -1 jika propvar1 kurang dari propvar2

Keterangan

Fungsi ini tidak membandingkan semua jenis; hanya tipe terpilih yang saat ini sebanding.

Secara default, vektor VT_NULL / VT_EMPTY / 0-elemen dianggap kurang dari vartype lainnya.

Jika vartypes berbeda, fungsi ini mencoba mengonversi propvar2 ke vartype propvar1 sebelum membandingkannya.

Catatan Perilaku fungsi ini, dan oleh karena itu hasil yang dikembalikannya, dapat berubah dari rilis ke rilis. Ini tidak boleh digunakan untuk aplikasi pengurutan kanonis.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 dengan SP1 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	propvarutil.h
Pustaka	Propsys.lib
DLL	Propsys.dll (versi 6.0 atau yang lebih baru)
Redistribusi	Windows Desktop Search (WDS) 3.0

Bagikan melalui