共用方式為

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 物件的指標，如果函式失敗，應該儲存錯誤的其他資訊。

傳回值

此函式可以傳回其中一個值。

傳回碼 Description
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
程式庫 WebServices.lib
Dll WebServices.dll