Função VarCmp (oleauto.h)

Compara duas variantes.

Sintaxe

HRESULT VarCmp(
  [in] LPVARIANT pvarLeft,
  [in] LPVARIANT pvarRight,
  [in] LCID      lcid,
  [in] ULONG     dwFlags
);

[in] pvarLeft

A primeira variante.

[in] pvarRight

A segunda variante.

[in] lcid

O identificador de localidade.

[in] dwFlags

A opção comparar resultados.

Valor	Significado
NORM_IGNORECASE 0x00000001	Ignorar maiúsculas e minúsculas.
NORM_IGNORENONSPACE 0x00000002	Ignorar caracteres nãospace.
NORM_IGNORESYMBOLS 0x00000004	Ignorar símbolos.
NORM_IGNOREWIDTH 0x00000008	Ignorar largura da cadeia de caracteres.
NORM_IGNOREKANATYPE 0x00000040	Ignorar o tipo Kana.
NORM_IGNOREKASHIDA 0x00040000	Ignorar caracteres kashida árabes.

Essa função pode retornar um desses valores.

Valor/código retornado	Descrição
VARCMP_LT 0	pvarLeft é menor que pvarRight.
VARCMP_EQ 1	Os parâmetros são iguais.
VARCMP_GT 2	pvarLeft é maior que pvarRight.
VARCMP_NULL 3	Qualquer uma das expressões é NULL.

A função só compara o valor dos tipos variantes. Ele compara cadeias de caracteres, inteiros e pontos flutuantes, mas não matrizes ou registros.

NORM_IGNOREWIDTH faz com que VarCmp ignore a diferença entre caracteres de meia largura e largura total, como demonstra o exemplo a seguir:

"Cat"== "cat"

A forma de largura total é uma distinção de formatação usada em scripts em chinês e japonês.