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 |
Library | WebServices.lib |
DLL | WebServices.dll |