Функция InternetCombineUrlW (wininet.h)
Объединяет базовый и относительный URL-адрес в один URL-адрес. Результирующий URL-адрес канонизируется (см. раздел InternetCanonicalizeUrl).
Синтаксис
BOOL InternetCombineUrlW(
[in] LPCWSTR lpszBaseUrl,
[in] LPCWSTR lpszRelativeUrl,
[out] LPWSTR lpszBuffer,
[in, out] LPDWORD lpdwBufferLength,
[in] DWORD dwFlags
);
Параметры
[in] lpszBaseUrl
Указатель на строку, завершающуюся значением NULL, которая содержит базовый URL-адрес.
[in] lpszRelativeUrl
Указатель на строку, завершающуюся значением NULL, которая содержит относительный URL-адрес.
[out] lpszBuffer
Указатель на буфер, получающий объединенный URL-адрес.
[in, out] lpdwBufferLength
Указатель на переменную, содержащую размер буфера lpszBuffer в символах. Если функция выполнена успешно, этот параметр получает размер объединенного URL-адреса в символах, не включая символ конца null. Если функция завершается сбоем, этот параметр получает размер требуемого буфера в символах (включая символ конца null).
[in] dwFlags
Управляет операцией функции . Этот параметр может принимать одно из указанных ниже значений.
Значение | Значение |
---|---|
|
Не кодирует и не декодирует символы после "#" или "?", а также не удаляет пробелы после "?". Если это значение не указано, кодируется весь URL-адрес и удаляются пробелы в конце. |
|
Преобразует все последовательности %XX в символы, включая escape-последовательности, перед анализом URL-адреса. |
|
Кодирует все встречающиеся знаки процента. По умолчанию знаки процента не кодируются. Это значение доступно в Microsoft Internet Обозреватель 5 и более поздних версий. |
|
Кодирует только пробелы. |
|
Не преобразует небезопасные символы в escape-последовательности. |
|
Не удаляет мета-последовательности (например, "." и "..") из URL-адреса. |
Возвращаемое значение
Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. Возможные ошибки:
Код возврата | Описание |
---|---|
|
Не удалось объединить URL-адреса. |
|
Буфер, предоставленный функции, был недостаточным или значением NULL. Значение, указанное параметром lpdwBufferLength , будет содержать количество байтов, необходимых для хранения объединенного URL-адреса. |
|
Недопустимый формат URL-адреса. |
|
Имеется недопустимый параметр строки, буфера, размера буфера или параметра flags. |
Комментарии
Примечание
Заголовок wininet.h определяет InternetCombineUrl в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | wininet.h |
Библиотека | Wininet.lib |
DLL | Wininet.dll |