Share via

WsWriteValue 函式 (webservices.h)

  • 發行項

這項作業會從基礎編碼衍生基本值的最佳標記法，並將衍生的值傳遞至 Writer 物件。

注意 使用這個函式來寫出基本值，而不是將值轉換成文字，以及後續使用 WsWriteChars會更有效率。

 

語法

HRESULT WsWriteValue(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_VALUE_TYPE valueType,
                 const void    *value,
  [in]           ULONG         valueSize,
  [in, optional] WS_ERROR      *error
);

參數

[in] writer

寫入值 之WS_XML_WRITER 物件的指標。 指標必須參考有效的 XML 寫入器 物件。

[in] valueType

指出 value 參數所參考的基本數值型別。

I

value

基本值的 void 指標。

[in] valueSize

要寫入之值的位元組大小。

[in, optional] error

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

傳回值

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

傳回碼 描述
E_INVALIDARG
 一或多個引數無效。
WS_E_INVALID_OPERATION
 由於 物件的目前狀態，不允許此作業。

備註

WsWriteValue 只能在 WsWriteStartAttribute 與 WsWriteEndAttribute之間呼叫一次。 寫入屬性時，它可能不會與 WsWriteChars、 WsWriteBytes、 WsWriteCharsUtf8 或 WsWriteText 結合。

規格需求

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