WsPushBytes 函数 (webservices.h)

  • 项目

建立要调用的回调以在元素中写入字节。 在某些编码中，通过消除数据副本可以更高效。

语法

HRESULT WsPushBytes(
  [in]           WS_XML_WRITER          *writer,
  [in]           WS_PUSH_BYTES_CALLBACK callback,
  [in, optional] void                   *callbackState,
  [in, optional] WS_ERROR               *error
);

参数

[in] writer

指向要向其写入字节的 XML Writer 对象的指针。 指针必须引用有效的 WS_XML_WRITER 并且引用的值不能为 NULL。

[in] callback

此参数是要调用以写入数据的回调。

[in, optional] callbackState

指向传递给回调函数的用户定义状态的指针。

[in, optional] error

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

返回值

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

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

注解

使用 WS_XML_WRITER_MTOM_ENCODING 进行写入时， WsPushBytes 提供了一种将字节直接写入其自己的 MIME 部件并避免复制的方法。 但是，编写器可以自行决定立即调用回调，因此调用方应为此做好准备。

如果编码无法利用此行为，则 WsPushBytes 将立即调用回调，并像调用 WsWriteBytes 一样运行。

要求

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