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物件的指標,如果函式失敗,應該儲存錯誤的其他資訊。
傳回值
此函式可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
一或多個引數無效。 |
|
由於 物件的目前狀態,不允許此作業。 |
備註
WsWriteValue 只能在 WsWriteStartAttribute 與 WsWriteEndAttribute之間呼叫一次。 寫入屬性時,它可能不會與 WsWriteChars、 WsWriteBytes、 WsWriteCharsUtf8 或 WsWriteText 結合。
規格需求
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | webservices.h |
程式庫 | WebServices.lib |
Dll | WebServices.dll |