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

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

  • Статья

Кодирует указанный WS_URL в строку URL-адреса с учетом ее составных частей. Значения экранируются по мере необходимости, объединяются и сохраняются в указанном WS_HEAP, а результат возвращается в виде WS_STRING.

Синтаксис

HRESULT WsEncodeUrl(
  [in]           const WS_URL *url,
  [in]           ULONG        flags,
  [in]           WS_HEAP      *heap,
  [out]          WS_STRING    *outUrl,
  [in, optional] WS_ERROR     *error
);

Параметры

[in] url

Ссылка на WS_URL для кодирования.

[in] flags

Значение этого параметра определяет метод оценки схемы URL-адресов. См . WS_URL_FLAGS.

[in] heap

Указатель на WS_HEAP , в котором выделяется URL-адрес.

[out] outUrl

Указатель на результирующую строку URL-адреса.

[in, optional] error

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

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

Эта функция может возвращать одно из этих значений.

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

Комментарии

Если схема не распознается в параметре URL-адреса , функция возвращает WS_E_INVALID_FORMAT.
Поддерживаются только типы схем, определенные в WS_URL_SCHEME_TYPE .

Требования

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