共用方式為

WsWriteType 函式 (webservices.h)

  • 發行項

根據 WS_TYPE_MAPPING ，將指定 WS_TYPE的值寫入 XML。

語法

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

參數

[in] writer

要寫入值的寫入器。

[in] typeMapping

描述類型如何對應至正在寫入的 XML。

[in] type

要序列化之值的類型。

[in, optional] typeDescription

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

[in] writeOption

值是否為必要專案，以及值配置方式。 如需詳細資訊 ，請參閱WS_WRITE_OPTION 。

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

value

要串行化之值的指標。

[in] valueSize

要串行化之值的大小。

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_E_INVALID_FORMAT
 輸入數據的格式不正確，或沒有預期的值。
E_INVALIDARG
 一或多個引數無效。
E_OUTOFMEMORY
 記憶體不足。
其他錯誤
此函式可能會傳回上述未列出的其他錯誤。

備註

請參閱 WS_TYPE_MAPPING ，以瞭解如何使用此函式在元素和屬性中寫入值。

如果 API 失敗，輸入寫入器的狀態就會變成未定義。 如果發生此情況，則寫入器上唯一可使用的 API 是 WsSetOutput 和 WsSetOutputToBuffer ，以將寫入器傳回可用狀態，或 WsFreeWriter 釋放寫入器。

規格需求

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