UrlCompareA-Funktion (shlwapi.h)

Bei zwei URL-Zeichenfolgen wird die Groß-/Kleinschreibung verglichen.

Syntax

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

Parameter

[in] psz1

Typ: PCTSTR

Eine null-endende Zeichenfolge mit maximaler Länge INTERNET_MAX_URL_LENGTH, die die erste URL enthält.

[in] psz2

Typ: PCTSTR

Eine null-endende Zeichenfolge mit maximaler Länge INTERNET_MAX_URL_LENGTH, die die zweite URL enthält.

fIgnoreSlash

Typ: BOOL

Ein Wert, der auf TRUE festgelegt ist, damit UrlCompare ein nachfolgendes "/"-Zeichen auf einer oder beiden URLs ignoriert.

Rückgabewert

Typ: int

Gibt null zurück, wenn die beiden Zeichenfolgen gleich sind. Die Funktion gibt auch null zurück, wenn fIgnoreSlash auf TRUE festgelegt ist und eine der Zeichenfolgen ein nachfolgendes ""-Zeichen aufweist. Die Funktion gibt eine negative ganze Zahl zurück, wenn die Zeichenfolge, auf die von psz1 verwiesen wird, kleiner ist als die Zeichenfolge, auf die psz2 zeigt. Andernfalls wird eine positive ganze Zahl zurückgegeben.

Hinweise

Um optimale Ergebnisse zu erzielen, sollten Sie zunächst die URLs mit UrlCanonicalize kanonisieren. Vergleichen Sie dann die kanonischen URLs mit UrlCompare.

Hinweis

Der shlwapi.h-Header definiert UrlCompare als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

Strcmp