WsReadBytes 函数 (webservices.h)

从读取器读取文本,并根据 base64 规范将字符解码为字节。

语法

HRESULT WsReadBytes(
  [in]           WS_XML_READER *reader,
                 void          *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
超出配额。

注解

文本读取到起始元素或结束元素。 跳过注释,并且 CDATA 内容与元素内容相同。

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

要求

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