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

Статья
11/20/2024

Преобразует путь Microsoft MS-DOS в канонизированный URL-адрес.

Синтаксис

LWSTDAPI UrlCreateFromPathA(
  [in]      PCSTR pszPath,
  [out]     PSTR  pszUrl,
  [in, out] DWORD *pcchUrl,
            DWORD dwFlags
);

Параметры

[in] pszPath

Тип: PCTSTR

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

[out] pszUrl

Тип: PTSTR

Указатель на буфер, который, когда эта функция возвращается успешно, получает URL-адрес.

[in, out] pcchUrl

Тип: DWORD*

Количество символов в pszUrl.

dwFlags

Тип: DWORD

Скрытный. Задайте для этого параметра значение NULL.

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

Тип: HRESULT

Возвращает S_FALSE, если pszPath уже имеет формат URL-адреса. В этом случае pszPath просто копируются в pszUrl. В противном случае возвращается S_OK в случае успешного выполнения или стандартного значения ошибки COM, если нет.

Замечания

ПримечаниеUrlCreateFromPath не поддерживает расширенные пути. Это пути, включающие префикс расширенной длины пути "\\?\".

Заметка

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

Требования

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

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