共用方式為

WsReadMetadata 函式 (webservices.h)

  • 發行項

讀取 Metadata 元素，並將它新增至 Metadata 物件的元數據檔。

元數據物件狀態必須設定為 WS_METADATA_STATE_CREATED。

發生錯誤時，元數據對象狀態會重設為 WS_METADATA_STATE_FAULTED。

注意 如果專案包含元數據，函式會取用元素。 如果元素無法辨識為包含元數據，或不需要特定類型的元數據，則不會讀取它的專案。
 

語法

HRESULT WsReadMetadata(
  [in]           WS_METADATA     *metadata,
  [in]           WS_XML_READER   *reader,
  [in]           const WS_STRING *url,
  [in, optional] WS_ERROR        *error
);

參數

[in] metadata

元數據物件的指標，用於儲存讀取的元數據。 指標必須參考有效的 WS_METADATA 物件。

[in] reader

用來讀取元數據的 XML 讀取器 物件的指標。 指標必須參考有效的 WS_XML_READER 物件，而且讀取器必須位於包含所需元數據的專案上。

[in] url

參考所擷取元數據 URL 之WS_STRING 物件的指標。 URL 可用來追蹤元數據檔，以解析檔之間的URL連結。

注意 URL 必須完整。 URL 可以有片段標識碼。
 

支援下列網址設定：

  • WS_URL_HTTP_SCHEME_TYPE
  • WS_URL_HTTPS_SCHEME_TYPE
  • WS_URL_NETTCP_SCHEME_TYPE
使用此函式指定的每個 URL 都必須有唯一的基底 URL。 基底 URL 是藉由從指定的 URL 移除任何片段標識碼來計算。

例如，如果已指定下列 URL：


http://example.com/document1#fragment
http://example.com/document2

這兩個基底 URL 會是：


http://example.com/document1
http://example.com/document2

[in, optional] error

WS_ERROR 物件的指標，如果函式失敗，應該儲存錯誤的其他資訊。

傳回值

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

傳回碼 Description
WS_E_INVALID_FORMAT
 輸入數據的格式不正確，或沒有預期的值。
WS_E_INVALID_OPERATION
 由於物件的目前狀態，不允許此作業。
WS_E_QUOTA_EXCEEDED
 超過配額。
E_OUTOFMEMORY
 記憶體不足。
E_INVALIDARG
 一或多個引數無效。
S_FALSE
 未取用元素。
其他錯誤
此函式可能會傳回上述未列出的其他錯誤。

備註

此函式可辨識下列類型的元資料：

  • WSDL 1.1 檔
  • WS-Policy 1.2 份檔

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll