Funzione PropVariantCompareEx (propvarutil.h)

Estende PropVariantCompare consentendo al chiamante di confrontare due strutture PROPVARIANT in base alle unità di confronto e ai flag specificati.

Sintassi

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

Parametri

[in] propvar1

Tipo: REFPROPVARIANT

Riferimento alla prima struttura PROPVARIANT .

[in] propvar2

Tipo: REFPROPVARIANT

Riferimento alla seconda struttura PROPVARIANT .

[in] unit

Tipo: PROPVAR_COMPARE_UNIT

Specifica, se appropriato, una delle unità di confronto definite in PROPVAR_COMPARE_UNIT.

[in] flags

Tipo: PROPVAR_COMPARE_FLAGS

Specifica una delle seguenti opzioni:

PVCF_DEFAULT (0x00000000)

Quando si confrontano stringhe, usare StrCmpLogical.

PVCF_TREATEMPTYASGREATERTHAN (0x00000001)

Considerare i valori vuoti o Null come maggiori di valori non vuoti. Questo valore può essere OR-ed con qualsiasi altro valore.

PVCF_USESTRCMP (0x00000002)

Quando si confrontano stringhe, usare StrCmp.

PVCF_USESTRCMPC (0x00000004)

Quando si confrontano stringhe, usare StrCmpC.

PVCF_USESTRCMPI (0x00000008)

Quando si confrontano stringhe, usare StrCmpI.

PVCF_USESTRCMPIC (0x00000010)

Quando si confrontano stringhe, usare StrCmpIC.

Valore restituito

Tipo: INT

• Restituisce 1 se propvar1 è maggiore di propvar2
• Restituisce 0 se propvar1 è uguale a propvar2
• Restituisce -1 se propvar1 è minore di propvar2

Commenti

Questa funzione non confronta tutti i tipi; solo i tipi selezionati sono attualmente confrontabili.

Per impostazione predefinita, i vettori di VT_NULL/VT_EMPTY/0 vengono considerati minori di qualsiasi altro tipo vartype.

Se i vartype sono diversi, questa funzione tenta di convertire propvar2 nel tipo vartype di propvar1 prima di confrontarli.

Requisiti