WsWriteBytes 函数 (webservices.h)

  • 项目

以针对编码优化的格式将字节写入编写器。 在文本编码中写入时，它将发出以 base64 编码的字节。 写入二进制格式时，它将直接发出字节。

语法

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

参数

[in] writer

要向其写入字节的编写器。

bytes

要写入文档的字节数。

[in] byteCount

要写入文档的字节数。

[in, optional] error

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

返回值

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

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

注解

WsWriteBytes 可以在 WsWriteStartAttribute 和 WsWriteEndAttribute 之间多次调用。 编写属性时，它不能与 WsWriteChars、 WsWriteCharsUtf8、 WsWriteValue 或 WsWriteText 结合使用。

对于 WS_XML_WRITER_MTOM_ENCODING，如果 byteCount 超过 在 WsSetOutput 期间指定的 maxInlineByteCount，则字节将被缓冲并放置在其自己的 MIME 部件中。 否则，字节以 base64 编码并直接放置在文档中。

对于 WS_XML_WRITER_MTOM_ENCODING，如果包含字节的元素具有名为“contentType”和命名空间“”http://www.w3.org/2004/11/xmlmime的属性，则该属性的值将反映在 MIME 部分的内容类型标头中，如 XML 二进制优化打包中所述。

要求

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