Функция WsCombineUrl (webservices.h)

Создает абсолютный URL-адрес из указанной ссылки на URL-адрес (абсолютный или относительный URL-адрес) и указанный абсолютный базовый URL-адрес.

Синтаксис

HRESULT WsCombineUrl(
  [in]           const WS_STRING *baseUrl,
  [in]           const WS_STRING *referenceUrl,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
  [out]          WS_STRING       *resultUrl,
  [in, optional] WS_ERROR        *error
);

Параметры

[in] baseUrl

Указатель на структуру WS_STRING , содержащую абсолютный URL-адрес в закодированном формате.

[in] referenceUrl

Указатель на структуру WS_STRING , содержащую абсолютный или относительный URL-адрес в закодированном формате.

[in] flags

Управляет форматом результирующего URL-адреса. Дополнительные сведения см. в разделе WS_URL_FLAGS.

[in] heap

Указатель на объект WS_HEAP , из которого выделяется память для результирующего URL-адреса.

[out] resultUrl

Указатель на структуру WS_STRING , которая получает полученный URL-адрес. Это абсолютный URL-адрес в закодированном формате.

[in, optional] error

Указатель на структуру WS_ERROR , которая получает дополнительные сведения об ошибке в случае сбоя функции.

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

Если функция завершается успешно, она возвращает NO_ERROR; в противном случае возвращается код ошибки HRESULT.

Код возврата	Описание
E_INVALIDARG	Один или несколько аргументов являются недопустимыми.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.
WS_E_INVALID_FORMAT	Базовый URL-адрес или URL-адрес ссылки не был в правильном формате или имел схему, которая не была распознана.
Другие ошибки	Эта функция может возвращать другие ошибки, не перечисленные выше.

Комментарии

Если URL-адрес ссылки является абсолютным, он возвращается без изменений, если это разрешено указанными флагами. Если url-адрес ссылки относительный, он объединяется с базовым URL-адресом перед возвратом.

Поддерживаются только схемы, перечисленные в WS_URL_SCHEME_TYPE .

Требования

Минимальная версия клиента	Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	webservices.h
Библиотека	WebServices.lib
DLL	WebServices.dll