Função VarBstrCmp (oleauto.h)

Compara duas variantes do tipo BSTR.

Sintaxe

HRESULT VarBstrCmp(
  [in] BSTR  bstrLeft,
  [in] BSTR  bstrRight,
  [in] LCID  lcid,
  [in] ULONG dwFlags
);

[in] bstrLeft

A primeira variante.

[in] bstrRight

A segunda variante.

[in] lcid

O identificador de localidade do programa para determinar se cadeias de caracteres UNICODE ou ANSI estão sendo usadas.

[in] dwFlags

Veja a seguir os sinalizadores de comparação de resultados.

Valor	Significado
NORM_IGNORECASE 0x00000001	Ignorar maiúsculas e minúsculas.
NORM_IGNORENONSPACE 0x00000002	Ignorar caracteres que não são do espaço.
NORM_IGNORESYMBOLS 0x00000004	Ignorar símbolos.
NORM_IGNOREWIDTH 0x00000008	Ignorar a 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	bstrLeft é menor que bstrRight.
VARCMP_EQ 1	Os parâmetros são iguais.
VARCMP_GT 2	bstrLeft é maior que bstrRight.

Essa função não comparará matrizes ou registros.