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

Статья
11/20/2024

Проверяет, является ли URL-адрес указанным типом.

Синтаксис

BOOL UrlIsA(
  [in] PCSTR pszUrl,
       URLIS UrlIs
);

Параметры

[in] pszUrl

Тип: PCTSTR

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

UrlIs

Тип: URLIS

Тип проверяемого URL-адреса. Этот параметр может принимать одно из следующих значений.

URLIS_APPLIABLE

Попытайтесь определить допустимую схему для URL-адреса.

URLIS_DIRECTORY

Заканчивается ли строка URL-адреса каталогом?

URLIS_FILEURL

URL-адрес файла?

URLIS_HASQUERY

Имеет ли URL-адрес добавленную строку запроса?

URLIS_NOHISTORY

URL-адрес, который обычно не отслеживается в журнале навигации?

URLIS_OPAQUE

Непрозрачные URL-адрес?

URLIS_URL

Является ли URL-адрес допустимым?

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

Тип: BOOL

Для всех типов URL-адресов url-адреса возвращает TRUE, если URL-адрес является указанным типом или FALSE, если нет.

Если URL-адреса задано значение URLIS_APPLIABLE, URL-адреса попытается определить схему URL-адресов. Если функция может определить схему, она возвращает TRUEили FALSE в противном случае.

Замечания

Заметка

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

Требования

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

См. также

UrlIsFileUrl

UrlIsNoHistory

UrlIsOpaque

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