共用方式為

WsWriteElement 函式 (webservices.h)

  • 發行項

將具型別的值寫入為 XML 專案。

語法

HRESULT WsWriteElement(
  [in]           WS_XML_WRITER                *writer,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

參數

[in] writer

要寫入專案的寫入器。

[in] elementDescription

如何串行化專案的描述指標。

[in] writeOption

如何配置值的相關信息。 如需詳細資訊 ，請參閱WS_WRITE_OPTION 。

value

要串行化之值的指標。

[in] valueSize

要串行化之值的大小，以位元組為單位。

如果值為 NULL，則大小應為 0。

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_E_INVALID_FORMAT
 輸入數據不是預期的格式，或沒有預期的值。
E_INVALIDARG
 一或多個引數無效。
E_OUTOFMEMORY
 記憶體不足。

備註

此 API 會寫入 start 元素、屬性、子元素/文字，以及對應至指定值的 end 元素。

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

規格需求

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