Função UrlCompareA (shlwapi.h)

Faz uma comparação que diferencia maiúsculas de minúsculas de duas cadeias de caracteres de URL.

Sintaxe

int UrlCompareA(
  [in] PCSTR psz1,
  [in] PCSTR psz2,
       BOOL  fIgnoreSlash
);

Parâmetros

[in] psz1

Tipo: PCTSTR

Uma cadeia de caracteres terminada em nulo de comprimento máximo INTERNET_MAX_URL_LENGTH que contém a primeira URL.

[in] psz2

Tipo: PCTSTR

Uma cadeia de caracteres terminada em nulo de comprimento máximo INTERNET_MAX_URL_LENGTH que contém a segunda URL.

fIgnoreSlash

Tipo: BOOL

Um valor definido como TRUE para que UrlCompare ignore um caractere '/' à direita em ambas as URLs ou .

Retornar valor

Tipo: int

Retornará zero se as duas cadeias de caracteres forem iguais. A função também retornará zero se fIgnoreSlash estiver definido como TRUE e uma das cadeias de caracteres tiver um caractere '' à direita. A função retornará um inteiro negativo se a cadeia de caracteres apontada por psz1 for menor que a cadeia de caracteres apontada por psz2. Caso contrário, retornará um inteiro positivo.

Comentários

Para obter melhores resultados, primeiro você deve canonizar as URLs com UrlCanonicalize. Em seguida, compare as URLs canônicas com UrlCompare.

Observação

O cabeçalho shlwapi.h define UrlCompare como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlwapi.h
Biblioteca Shlwapi.lib
DLL Shlwapi.dll (versão 5.0 ou posterior)

Confira também

Strcmp