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

指向要计算的 URL 的WS_STRING 表示形式的指针。

[in] flags

确定 URL 方案评估方法。 请参阅 WS_URL_FLAGS。

[in] heap

指向要在其中分配返回的 URL 引用的 WS_HEAP 的指针。

outUrl

对封装 WS_URL_SCHEME_TYPE 值的 WS_URL 结构的引用。

[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@hostname：port) (userinfo 部分。

如果未指定任何端口，则返回该方案的默认端口。

如果未为 soap.udp 方案指定端口0xFFFFFFFF将作为默认值返回。

要求

要求 值
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll