通过

WsWriteXmlBufferToBytes 函数 (webservices.h)

  • 项目

使用编写器将 WS_XML_BUFFER 转换为编码的字节集。

语法

HRESULT WsWriteXmlBufferToBytes(
  [in]           WS_XML_WRITER                *writer,
  [in]           WS_XML_BUFFER                *xmlBuffer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in]           WS_HEAP                      *heap,
                 void                         **bytes,
  [out]          ULONG                        *byteCount,
  [in, optional] WS_ERROR                     *error
);

参数

[in] writer

用于生成编码字节的编写器。

[in] xmlBuffer

要写入的 XML 缓冲区。

[in, optional] encoding

生成字节时要使用的编码。 如果 为 NULL，则字节将采用 utf8 进行编码。

properties

编写器的可选属性数组。 请参阅 WS_XML_WRITER_PROPERTY。

[in] propertyCount

属性数。

[in] heap

要从中分配字节的堆。

bytes

此处返回生成的字节。

[out] byteCount

此处返回生成的字节数。

[in, optional] error

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

返回值

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

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

注解

该函数将生成 WS_XML_BUFFER 的整个内容，作为一组线性字节，以指定的编码从指定的堆分配。

调用此函数后，编写器将处于未定义状态。 但是， WsWriteXmlBufferToBytes 可以再次与此类编写器一起使用。 否则，应使用 WsSetOutput 或 WsSetOutputToBuffer 将编写器恢复到已知状态，或者应使用 WsFreeWriter 释放编写器。

要求

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