WsWriteChars 函数 (webservices.h)
将一系列字符写入元素或属性。
若要将字符写入属性值,请首先调用 WsWriteStartAttribute 。 除非 WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT 已设置为 TRUE,否则 xml 文档的根目录中只能写入空格字符。
语法
HRESULT WsWriteChars(
[in] WS_XML_WRITER *writer,
const WCHAR *chars,
[in] ULONG charCount,
[in, optional] WS_ERROR *error
);
参数
[in] writer
指向写入字符 的WS_XML_WRITER 对象的指针。 指针必须引用有效的 XML 编写器 对象。
chars
指向要写入的字符的指针。
[in] charCount
要写入的字符数。
[in, optional] error
指向 WS_ERROR 对象的指针,如果函数失败,应存储有关错误的其他信息。
返回值
此函数可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
一个或多个参数无效。 |
|
由于对象的当前状态,不允许该操作。 |
注解
可以在 WsWriteStartAttribute 和 WsWriteEndAttribute 之间多次调用 WsWriteChars。 写入属性时,它不能与 WsWriteCharsUtf8、 WsWriteBytes、 WsWriteValue 或 WsWriteText 结合使用 。
要求
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | webservices.h |
Library | WebServices.lib |
DLL | WebServices.dll |