WsReadCharsUtf8 函数 (webservices.h)

  • 项目

从读取器中读取指定数量的文本字符，并返回以 UTF-8 编码的字符。

语法

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

参数

[in] reader

指向应从中读取字符数据的 XML 读取器的 指针。 指针必须引用有效的 WS_XML_READER 对象。

bytes

指向缓冲区的指针，用于放置已读取的编码字节。

[in] maxByteCount

应读取的最大字节数。

[out] actualByteCount

指向已读取的实际字节数的 ULONG 值的指针。 即使剩余的字节数更多，也可能小于 maxByteCount。 如果返回零，则不再有字节。

[in, optional] error

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

返回值

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

返回代码 说明
WS_E_INVALID_FORMAT
 输入数据未采用预期格式或没有预期值。
WS_E_QUOTA_EXCEEDED
 超出配额。

注解

XML 文本读取到起始元素或结束元素。 跳过注释，并且 CDATA 内容与元素内容相同。 字符实体将转换为其非转义形式。

此函数可能会因 WsReadNode 中列出的任何原因而失败。

要求

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