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

指向要在其中分配 URL 的WS_HEAP 的指针。

[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
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll