通过

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

指向包含编码格式的绝对 URL 的WS_STRING 结构的指针。

[in] referenceUrl

指向 WS_STRING 结构的指针，该结构包含采用编码格式的绝对 URL 或相对 URL。

[in] flags

控制生成的 URL 的格式。 有关详细信息，请参阅 WS_URL_FLAGS。

[in] heap

指向 WS_HEAP 对象的指针，从该对象中分配生成的 URL 的内存。

[out] resultUrl

指向接收结果 URL 的 WS_STRING 结构的指针。 这是编码格式的绝对 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
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll