WsMoveWriter 函数 (webservices.h)

  • 项目

移动由 moveTo 参数指定的编写器当前位置。

语法

HRESULT WsMoveWriter(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

参数

[in] writer

要移动的编写器。

[in] moveTo

要移动编写器的相对位置。

found

如果这是非 NULL，则此处返回新位置是否可以移动到 。

如果这是 NULL，并且无法将位置移动到 ，则该函数将返回 WS_E_INVALID_FORMAT。 (请参阅 Windows Web Services 返回值。)

[in, optional] error

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

返回值

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

返回代码 说明
E_INVALIDARG
 一个或多个参数无效。
WS_E_INVALID_OPERATION
 由于对象的当前状态，不允许该操作。
WS_E_INVALID_FORMAT
 输入数据未采用预期格式或没有预期值。

注解

这只能在设置为 WS_XML_BUFFER的编写器上使用。

如果找到的参数不为 NULL，它将指示它是否可以移动到请求的节点并返回 NOERROR。

如果找到的参数为 NULL，并且找不到请求的节点，它将返回 WS_E_INVALID_FORMAT。

定位后，编写器将在指定位置之前插入新数据。

要求

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