WsRemoveNode 函式 (webservices.h)
從 xml 緩衝區移除位於指定位置的節點。 如果位於元素上,則會移除包含其所有子系及其對應結束元素的項目,否則會移除單一節點。
使用任何 API 搭配目前相依於此位置或此位置子系的 WS_XML_READER 或 WS_XML_WRITER 將會失敗。 必須先重新置放WS_XML_READER或WS_XML_WRITER,才能進一步使用。
如果節點位於結尾專案或檔的根目錄,則會傳回 WS_E_INVALID_OPERATION 。 (請參閱 Windows Web 服務傳回值。)
呼叫 WsRemoveNode 之後呼叫 WsSetReaderPosition 或 WsSetWriterPosition 將會失敗。
語法
HRESULT WsRemoveNode(
[in] const WS_XML_NODE_POSITION *nodePosition,
[in, optional] WS_ERROR *error
);
參數
[in] nodePosition
應移除之節點的位置。
[in, optional] error
指定函式失敗時應該儲存其他錯誤資訊的位置。
傳回值
此函式可以傳回其中一個值。
傳回碼 | Description |
---|---|
|
由於物件的目前狀態,不允許此作業。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | webservices.h |
程式庫 | WebServices.lib |
Dll | WebServices.dll |