Compartilhar via

Função PropVariantCompareEx (propvarutil.h)

  • Artigo

Estende PropVariantCompare permitindo que o chamador compare duas estruturas PROPVARIANT com base em unidades de comparação e sinalizadores especificados.

Sintaxe

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

Referência à primeira estrutura PROPVARIANT .

[in] propvar2

Tipo: REFPROPVARIANT

Referência à segunda estrutura PROPVARIANT .

[in] unit

Tipo: PROPVAR_COMPARE_UNIT

Especifica, quando apropriado, uma das unidades de comparação definidas em PROPVAR_COMPARE_UNIT.

[in] flags

Tipo: PROPVAR_COMPARE_FLAGS

Especifica um dos seguintes:

PVCF_DEFAULT (0x00000000)

Ao comparar cadeias de caracteres, use StrCmpLogical.

PVCF_TREATEMPTYASGREATERTHAN (0x00000001)

Considerar valores vazios ou nulos como maiores que valores não vazios. Esse valor pode ser OR-ed com qualquer outro valor.

PVCF_USESTRCMP (0x00000002)

Ao comparar cadeias de caracteres, use StrCmp.

PVCF_USESTRCMPC (0x00000004)

Ao comparar cadeias de caracteres, use StrCmpC.

PVCF_USESTRCMPI (0x00000008)

Ao comparar cadeias de caracteres, use StrCmpI.

PVCF_USESTRCMPIC (0x00000010)

Ao comparar cadeias de caracteres, use StrCmpIC.

Retornar valor

Tipo: INT

  • Retorna 1 se propvar1 for maior que propvar2
  • Retorna 0 se propvar1 for igual a propvar2
  • Retorna -1 se propvar1 for menor que propvar2

Comentários

Essa função não compara todos os tipos; somente os tipos selecionados são comparáveis no momento.

Por padrão, os vetores VT_NULL/VT_EMPTY/0 elemento são considerados menores do que qualquer outro vartype.

Se os vartypes forem diferentes, essa função tentará converter propvar2 no vartype de propvar1 antes de compará-los.

Nota O comportamento dessa função e, portanto, os resultados retornados por ela, podem mudar de versão para versão. Ele não deve ser usado para aplicativos de classificação canônica.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 com SP1 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho propvarutil.h
Biblioteca Propsys.lib
DLL Propsys.dll (versão 6.0 ou posterior)
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0