Fonction UrlCompareA (shlwapi.h)
Effectue une comparaison respectant la casse de deux chaînes d’URL.
Syntaxe
int UrlCompareA(
[in] PCSTR psz1,
[in] PCSTR 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) |