Fonction PropVariantCompareEx (propvarutil.h)

Article
03/04/2024

Étend PropVariantCompare en permettant à l’appelant de comparer deux structures PROPVARIANT en fonction d’unités de comparaison et d’indicateurs spécifiés.

Syntaxe

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

Paramètres

[in] propvar1

Type : REFPROPVARIANT

Référence à la première structure PROPVARIANT .

[in] propvar2

Type : REFPROPVARIANT

Référence à la deuxième structure PROPVARIANT .

[in] unit

Type : PROPVAR_COMPARE_UNIT

Spécifie, le cas échéant, l’une des unités de comparaison définies dans PROPVAR_COMPARE_UNIT.

[in] flags

Type : PROPVAR_COMPARE_FLAGS

Spécifie l'un des éléments suivants :

PVCF_DEFAULT (0x00000000)

Lorsque vous comparez des chaînes, utilisez StrCmpLogical.

PVCF_TREATEMPTYASGREATERTHAN (0x00000001)

Considérez les valeurs vides ou null comme supérieures aux valeurs non vides. Cette valeur peut être OR-ed avec n’importe quelle autre valeur.

PVCF_USESTRCMP (0x00000002)

Lorsque vous comparez des chaînes, utilisez StrCmp.

PVCF_USESTRCMPC (0x00000004)

Lorsque vous comparez des chaînes, utilisez StrCmpC.

PVCF_USESTRCMPI (0x00000008)

Lorsque vous comparez des chaînes, utilisez StrCmpI.

PVCF_USESTRCMPIC (0x00000010)

Lorsque vous comparez des chaînes, utilisez StrCmpIC.

Valeur retournée

Type : INT

Renvoie 1 si propvar1 est supérieur à propvar2
Retourne 0 si propvar1 est égal à propvar2
Renvoie -1 si propvar1 est inférieur à propvar2

Remarques

Cette fonction ne compare pas tous les types ; seuls les types sélectionnés sont actuellement comparables.

Par défaut, les vecteurs VT_NULL/VT_EMPTY/0 élément sont considérés comme inférieurs à tout autre vartype.

Si les vartypes sont différents, cette fonction tente de convertir propvar2 en vartype de propvar1 avant de les comparer.

Note Le comportement de cette fonction, et par conséquent les résultats qu’elle retourne, peut changer de mise en production. Il ne doit pas être utilisé pour les applications de tri canonique.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	propvarutil.h
Bibliothèque	Propsys.lib
DLL	Propsys.dll (version 6.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Partager via