共用方式為

WsReadType 函式 (webservices.h)

  • 發行項

根據WS_TYPE_MAPPING從 XML 讀取指定WS_TYPE的值。

語法

HRESULT WsReadType(
  [in]           WS_XML_READER   *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_READ_OPTION  readOption,
  [in, optional] WS_HEAP         *heap,
                 void            *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

參數

[in] reader

位於要還原串行化之 XML 上的讀取器。

[in] typeMapping

描述類型如何對應至正在讀取的 XML。

[in] type

要還原串行化之值的型別。

[in, optional] typeDescription

類型的其他資訊。 每個類型都有不同的描述結構。 視WS_TYPE而定，這可能是 NULL。

[in] readOption

是否需要值，以及如何配置值。 如需詳細資訊 ，請參閱WS_READ_OPTION 。

此參數必須具有下列其中一個值：

[in, optional] heap

要儲存還原串行化值的堆積。

value

此參數的解譯取決於 WS_READ_OPTION。

[in] valueSize

此參數的解譯取決於 WS_READ_OPTION。

[in, optional] error

指定函式失敗時應儲存其他錯誤資訊的位置。

傳回值

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

傳回碼 Description
WS_E_INVALID_FORMAT
 輸入數據不是預期的格式，或沒有預期的值。
E_OUTOFMEMORY
 記憶體不足。
WS_E_QUOTA_EXCEEDED
 超過堆積的大小配額。
E_INVALIDARG
 一或多個引數無效。

備註

如需如何使用此函式從元素和屬性讀取值，請參閱 WS_TYPE_MAPPING 。

如果 API 失敗，輸入讀取器的狀態會變成未定義。 如果發生這種情況，則讀取器唯一可使用的 API 是 WsSetInput 和 WsSetInputToBuffer ，以將讀取器傳回可用狀態，或 WsFreeReader 釋出讀取器。

規格需求

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