Функция UrlCompareA (shlwapi.h)

Статья
11/20/2024

Выполняет сравнение двух строк URL-адресов с учетом регистра.

Синтаксис

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

Параметры

[in] psz1

Тип: PCTSTR

Строка, завершаемая значением NULL, INTERNET_MAX_URL_LENGTH максимальной длины, содержащей первый URL-адрес.

[in] psz2

Тип: PCTSTR

Строка, завершаемая значением NULL, INTERNET_MAX_URL_LENGTH, содержащая второй URL-адрес.

fIgnoreSlash

Тип: BOOL

Значение, которое имеет значение TRUE, чтобы UrlCompare игнорировать символ "/" в url-адресах или в обоих URL-адресах.

Возвращаемое значение

Тип: int

Возвращает ноль, если две строки равны. Функция также возвращает ноль, если для fIgnoreSlash задано значение TRUE, а одна из строк имеет конечный символ "". Функция возвращает отрицательное целое число, если строка, на которую указывает psz1, меньше строки, на которую указывает psz2. В противном случае возвращается положительное целое число.

Замечания

Для получения наилучших результатов необходимо сначала канонизировать URL-адреса с помощью UrlCanonicalize. Затем сравните канонические URL-адреса с UrlCompare.

Заметка

Заголовок shlwapi.h определяет UrlCompare как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

См. также

StrCmp

Поделиться через