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
指定函数失败时应存储其他错误信息的位置。
返回值
此函数可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
由于对象的当前状态,不允许该操作。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | webservices.h |
Library | WebServices.lib |
DLL | WebServices.dll |