Share via

WsWriteText 函数 (webservices.h)

  • 项目

将指定文本写入 XML 编写器。

若要将字符写入属性值，请调用 WsWriteStartAttribute。 除非 WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT 已设置为 TRUE，否则只能在 xml 文档的根目录中写入空格字符。

语法

HRESULT WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

参数

[in] writer

指向要向其写入文本 的 WS_XML_WRITER 对象的指针。 指针必须引用有效的 XML 编写器 对象。

[in] text

指向要写入的文本的指针。

注意 有关文本对象的详细信息，请参阅 WS_XML_TEXT 及其派生类。

 

[in, optional] error

指向 WS_ERROR 对象的指针，如果函数失败，应存储有关错误的其他信息。

返回值

此函数可以返回其中一个值。

返回代码 说明
E_INVALIDARG
 一个或多个参数无效。
WS_E_INVALID_OPERATION
 由于 对象的当前状态，不允许此操作。

注解

WsWriteText 只能在 WsWriteStartAttribute 和 WsWriteEndAttribute 之间调用一次，除非文本类型为以下类型之一：

  • WS_XML_TEXT_TYPE_UTF8
  • WS_XML_TEXT_TYPE_UTF16
  • WS_XML_TEXT_TYPE_BASE64
注意 如果文本 Type 设置为上述值之一，则可以多次调用 WsWriteText。 但是，对于特性内的所有调用，文本 Type 必须相同。
 

要求

   
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll