Função UrlCompareA (shlwapi.h)

Artigo
11/20/2024

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 ignorar um caractere '/' à direita em ambas as URLs.

Valor de retorno

Tipo: int

Retornará zero se as duas cadeias de caracteres forem iguais. A função também retornará zero se fIgnoreSlash estiver definida 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, ele retornará um inteiro positivo.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

strCmp

Compartilhar via