WsRemoveNode 函数 (webservices.h)

  • 项目

从 xml 缓冲区中移除位于指定位置的节点。 如果定位在元素上，它将删除该元素（包括其所有子元素及其相应的结束元素），否则将删除单个节点。

使用当前依赖于此位置或此位置的子级 WS_XML_READER 或 WS_XML_WRITER 的任何 API 都将失败。 在进一步使用之前，必须重新定位WS_XML_READER或WS_XML_WRITER。

如果节点位于文档的结束元素或根上，它将返回 WS_E_INVALID_OPERATION 。 (请参阅 Windows Web Services 返回值。)

在调用 WsRemoveNode 后调用 WsSetReaderPosition 或 WsSetWriterPosition 将失败。

语法

HRESULT WsRemoveNode(
  [in]           const WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR                   *error
);

参数

[in] nodePosition

应移除的节点的位置。

[in, optional] error

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

返回值

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

返回代码 说明
WS_E_INVALID_OPERATION
 由于对象的当前状态，不允许该操作。

要求

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