PropVariantCompareEx-Funktion (propvarutil.h)

Artikel
08/25/2023

Erweitert PropVariantCompare , indem der Aufrufer zwei PROPVARIANT-Strukturen basierend auf angegebenen Vergleichseinheiten und Flags vergleichen kann.

Syntax

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

Parameter

[in] propvar1

Typ: REFPROPVARIANT

Verweis auf die erste PROPVARIANT-Struktur .

[in] propvar2

Typ: REFPROPVARIANT

Verweis auf die zweite PROPVARIANT-Struktur .

[in] unit

Typ: PROPVAR_COMPARE_UNIT

Gibt ggf. eine der in PROPVAR_COMPARE_UNIT definierten Vergleichseinheiten an.

[in] flags

Typ: PROPVAR_COMPARE_FLAGS

Gibt eins der Folgenden an:

PVCF_DEFAULT (0x00000000)

Verwenden Sie beim Vergleichen von Zeichenfolgen StrCmpLogical.

PVCF_TREATEMPTYASGREATERTHAN (0x00000001)

Betrachten Sie leere oder NULL-Werte als größer als nicht leere Werte. Dieser Wert kann mit jedem anderen Wert OR-ediert werden.

PVCF_USESTRCMP (0x00000002)

Verwenden Sie beim Vergleichen von Zeichenfolgen StrCmp.

PVCF_USESTRCMPC (0x00000004)

Verwenden Sie beim Vergleichen von Zeichenfolgen StrCmpC.

PVCF_USESTRCMPI (0x00000008)

Verwenden Sie beim Vergleichen von Zeichenfolgen StrCmpI.

PVCF_USESTRCMPIC (0x00000010)

Verwenden Sie beim Vergleichen von Zeichenfolgen StrCmpIC.

Rückgabewert

Typ: INT

Gibt 1 zurück, wenn propvar1 größer als propvar2 ist.
Gibt 0 zurück, wenn propvar1gleich propvar2 ist.
Gibt -1 zurück, wenn propvar1 kleiner als propvar2 ist.

Hinweise

Diese Funktion vergleicht nicht alle Typen. nur ausgewählte Typen sind derzeit vergleichbar.

Standardmäßig werden VT_NULL/VT_EMPTY/0-Elementvektoren als kleiner als jeder andere Vartyp betrachtet.

Wenn die vartypes unterschiedlich sind, versucht diese Funktion, propvar2 in den vartype von propvar1 zu konvertieren, bevor sie verglichen werden.

Hinweis Das Verhalten dieser Funktion und damit die zurückgegebenen Ergebnisse können sich von Release zu Release ändern. Sie sollte nicht für kanonische Sortieranwendungen verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	propvarutil.h
Bibliothek	Propsys.lib
DLL	Propsys.dll (Version 6.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Freigeben über