Compartir a través de

Función PropVariantCompareEx (propvarutil.h)

  • Artículo

Extiende PropVariantCompare al permitir que el autor de la llamada compare dos estructuras PROPVARIANT basadas en unidades de comparación y marcas especificadas.

Sintaxis

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

Parámetros

[in] propvar1

Tipo: REFPROPVARIANT

Referencia a la primera estructura PROPVARIANT .

[in] propvar2

Tipo: REFPROPVARIANT

Referencia a la segunda estructura PROPVARIANT .

[in] unit

Tipo: PROPVAR_COMPARE_UNIT

Especifica, si procede, una de las unidades de comparación definidas en PROPVAR_COMPARE_UNIT.

[in] flags

Tipo: PROPVAR_COMPARE_FLAGS

Especifica uno de los siguientes:

PVCF_DEFAULT (0x00000000)

Al comparar cadenas, use StrCmpLogical.

PVCF_TREATEMPTYASGREATERTHAN (0x00000001)

Tenga en cuenta los valores vacíos o null como mayores que los valores no vacíos. Este valor puede ser OR con cualquier otro valor.

PVCF_USESTRCMP (0x00000002)

Al comparar cadenas, use StrCmp.

PVCF_USESTRCMPC (0x00000004)

Al comparar cadenas, use StrCmpC.

PVCF_USESTRCMPI (0x00000008)

Al comparar cadenas, use StrCmpI.

PVCF_USESTRCMPIC (0x00000010)

Al comparar cadenas, use StrCmpIC.

Valor devuelto

Tipo: INT

  • Devuelve 1 si propvar1 es mayor que propvar2.
  • Devuelve 0 si propvar1 es igual a propvar2.
  • Devuelve -1 si propvar1 es menor que propvar2.

Comentarios

Esta función no compara todos los tipos; actualmente, solo los tipos seleccionados son comparables.

De forma predeterminada, VT_NULL / VT_EMPTY / vectores de 0 elementos se consideran menores que cualquier otro tipo vartype.

Si los vartypes son diferentes, esta función intenta convertir propvar2 al vartype de propvar1 antes de compararlos.

Nota El comportamiento de esta función y, por lo tanto, los resultados que devuelve, pueden cambiar de versión a versión. No debe usarse para aplicaciones de ordenación canónicas.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 con SP1 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado propvarutil.h
Library Propsys.lib
Archivo DLL Propsys.dll (versión 6.0 o posterior)
Redistribuible Búsqueda de escritorio de Windows (WDS) 3.0