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

  • Статья

Создает 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
 Устаревшее — игнорируется.

[out] lpszUrl

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

[in, out] lpdwUrlLength

Указатель на переменную, указывающую размер буфера URL-адреса lpszUrl в TCHAR. При возврате функции этот параметр получает размер строки 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 (WinHTTP).
 

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wininet.h
Библиотека Wininet.lib
DLL Wininet.dll

См. также раздел

Обработка универсальных указателей ресурсов

Функции WinINet