WsReadXmlBufferFromBytes 函数 (webservices.h)

  • 项目

使用读取器将一组编码字节转换为 WS_XML_BUFFER。

语法

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

参数

[in] reader

用于分析编码字节的读取器。

[in, optional] encoding

分析字节时要使用的编码。 如果 为 NULL，将使用字符集为 WS_CHARSET_AUTO 的 WS_XML_READER_TEXT_ENCODING 。

properties

读取器的可选属性数组。 请参阅 WS_XML_READER_PROPERTY。

[in] propertyCount

属性数。

bytes

要分析的字节数。

[in] byteCount

要分析的字节数。

[in] heap

要从中分配 XML 缓冲区的堆。

xmlBuffer

在此处返回读取字节的 XML 缓冲区。

[in, optional] error

指定函数失败时应存储其他错误信息的位置。

返回值

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

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

注解

函数将根据指定的编码分析整个内容，并将其存储到 WS_XML_BUFFER中。

调用此函数后，读取器将保持未定义状态。 但是， WsReadXmlBufferFromBytes 可以与此类读取器一起使用。 否则，应使用 WsSetInput 或 WsSetInputToBuffer 将读取器恢复到已知状态，或者应使用 WsFreeReader 释放读取器。

要求

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