Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Removes the next node.

Script Syntax

Copy Code 
var 
objXMLDOMNode = objXMLDOMSelection.removeNext();

Remarks

Script Parameters

None.

Script Return Value

Object. Returns the node that was removed, or Null if there is no nextNode Method (IXMLDOMNamedNodeMap)to remove. If the parameter is Null, the removed node is not returned, but is still removed.

C/C++ Syntax

Copy Code 
HRESULT removeNext(
  IXMLDOMNode** 
ppNode
);

Remarks

C/C++ Parameters

ppNode

[out, retval] The node that was removed, or Null if there is no nextNode Method (IXMLDOMNamedNodeMap)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

Header msxml2.h, msxml2.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

General Remarks

The removeNextmethod is equivalent to the following (except that it also works for attributes).

Copy Code 
var node = list.peekNode();
node.parentNode.removeChild(node);

The side effect is that the length of the collection is decremented and the nextNodeand itemmethods will not return it because it has been removed.

This method applies to the following interface:

IXMLDOMSelection.

See Also

Other Resources