Функция InternetCreateUrlA (wininet.h)

Статья
11/20/2024

Создает URL-адрес из его компонентов.

Синтаксис

BOOL InternetCreateUrlA(
  [in]      LPURL_COMPONENTSA lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPSTR             lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

Параметры

[in] lpUrlComponents

Указатель на структуру URL_COMPONENTS, содержащую компоненты, из которых создается URL-адрес.

[in] dwFlags

Управляет операцией этой функции. Этот параметр может быть одним или несколькими из следующих значений.

Ценность	Значение
ICU_ESCAPE	Преобразует все небезопасные символы в соответствующие escape-последовательности в строке пути, на которую указывает элемент lpszUrlPath и в lpszExtraInfo строку дополнительной информации, на которую указывает член структуры URL_COMPONENTS, на которую указывает параметр lpUrlComponents. Версия Юникода InternetCreateUrl сначала попытается преобразовать с помощью системной кодовой страницы. Если это не удается вернуться к UTF-8.
ICU_USERNAME	Устаревший — игнорируется.

Ценность

Значение

ICU_ESCAPE

Преобразует все небезопасные символы в соответствующие escape-последовательности в строке пути, на которую указывает элемент lpszUrlPath и в lpszExtraInfo строку дополнительной информации, на которую указывает член структуры URL_COMPONENTS, на которую указывает параметр lpUrlComponents.

Версия Юникода InternetCreateUrl сначала попытается преобразовать с помощью системной кодовой страницы. Если это не удается вернуться к UTF-8.

ICU_USERNAME

Устаревший — игнорируется.

[out] lpszUrl

Указатель на буфер, получающий URL-адрес.

[in, out] lpdwUrlLength

Указатель на переменную, указывающую размер буфера URL-адреса lpszUrl, в TCHARs. Когда функция возвращается, этот параметр получает размер строки URL-адреса, за исключением конца NULL. Если GetLastError возвращает ERROR_INSUFFICIENT_BUFFER, этот параметр получает количество байтов, необходимых для хранения созданного URL-адреса.

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

Возвращает TRUE, если функция выполнена успешно или FALSE в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

При указании схемы в структуре URL_COMPONENTS, переданной lpUrlComponents, если lpszScheme не имеет значения NULL, он будет использоваться для схемы. Если lpszScheme имеет значение NULL, то схему можно указать с помощью перечисления INTERNET_SCHEME, задав nScheme требуемым INTERNET_SCHEME или INTERNET_SCHEME_DEFAULT.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для реализации или служб сервера microsoft Windows HTTP Services (WinHTTP).

Заметка

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

Требования

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

См. также

обработка единого указателя ресурсов

функций WinINet

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