removeNext Method (Windows CE 5.0)
Removes the next node.
[Script]
Script Syntax
varobjXMLDOMNode=objXMLDOMSelection.removeNext();
Script Parameters
None.
Script Return Value
Object. Returns the node that was removed, or Null if there is no nextNode(IXMLDOMNamedNodeMap) method to remove. If the parameter is Null, the removed node is not returned, but is still removed.
[C/C++]
C/C++ Syntax
HRESULT removeNext(IXMLDOMNode** ppNode);
C/C++ Parameters
- ppNode
[out, retval] The node that was removed, or Null if there is no nextNode(IXMLDOMNamedNodeMap) method to remove. If the parameter is Null, the removed node is not returned, but is still removed.
C/C++ Return Values
- S_OK
Value returned if the method is successful. - S_FALSE
Value returned if no nodes left in the selection. - E_PENDING
Value returned if all nodes cannot be found at this time (in which case no nodes are removed).
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Msxml2.h, Msxml2.idl.
Link Library: Uuid.lib.
General Remarks
The removeNext method is equivalent to the following (except that it also works for attributes).
var node = list.peekNode();
node.parentNode.removeChild(node);
The side effect is that the length of the collection is decremented and the nextNode and item methods will not return it because it has been removed.
This method applies to the following interface:
See Also
nextNode Method (IXMLDOMNamedNodeMap)
Send Feedback on this topic to the authors