Fonction UrlCompareW (shlwapi.h)

Article
03/04/2024

Effectue une comparaison respectant la casse de deux chaînes d’URL.

Syntaxe

int UrlCompareW(
  [in] PCWSTR psz1,
  [in] PCWSTR psz2,
       BOOL   fIgnoreSlash
);

Paramètres

[in] psz1

Type : PCTSTR

Chaîne terminée par null d’une longueur maximale INTERNET_MAX_URL_LENGTH qui contient la première URL.

[in] psz2

Type : PCTSTR

Chaîne terminée par un caractère Null de longueur maximale INTERNET_MAX_URL_LENGTH qui contient la deuxième URL.

fIgnoreSlash

Type : BOOL

Valeur définie sur TRUE pour que UrlCompare ignore un caractère de fin « / » sur l’une des URL ou les deux.

Valeur retournée

Type : int

Retourne zéro si les deux chaînes sont égales. La fonction retourne également zéro si fIgnoreSlash a la valeur TRUE et si l’une des chaînes a un caractère de fin « ». La fonction retourne un entier négatif si la chaîne pointée par psz1 est inférieure à la chaîne pointée par psz2. Sinon, elle retourne un entier positif.

Remarques

Pour obtenir de meilleurs résultats, vous devez d’abord canoniser les URL avec UrlCanonicalize. Ensuite, comparez les URL canoniques avec UrlCompare.

Notes

L’en-tête shlwapi.h définit UrlCompare en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Voir aussi

StrCmp

Partager via