共用方式為

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

傳回值

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

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