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

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

  • Статья

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

Синтаксис

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

Параметры

[in] url

Указатель на WS_STRING представление вычисляемого URL-адреса.

[in] flags

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

[in] heap

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

outUrl

Ссылка на структуру WS_URL , которая инкапсулирует значение WS_URL_SCHEME_TYPE .

[in, optional] error

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

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

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

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

Комментарии

Грамматику, проанализированную для схем "http", "https", "net.tcp" и "soap.udp", можно найти по адресу http://www.ietf.org/rfc/rfc3986.txt. Для этих схем:

  • Требуется непустое имя узла.
  • Для производства IP-литералов возвращаются все символы, обозначаемые символами "[" и "]". Они не применяются для использования рабочей среды IPv6Address.
  • Часть userinfo центра сертификации (например, userinfo@hostname:port) не поддерживается.

Если порт не указан, возвращается порт по умолчанию для этой схемы.

Если для схемы soap.udp не указан порт, 0xFFFFFFFF возвращается по умолчанию.

Требования

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