removeChild Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Removes the specified child node from the list of children and returns it.

Script Syntax

var objXMLDOMNode = oXMLDOMNode.removeChild(childNode);

Remarks

Script Parameters

• childNode
  Object. Child node to be removed from the list of children of this node.

Script Return Value

Object. Returns the removed child node.

C/C++ Syntax

HRESULT removeChild(
  IXMLDOMNode* childNode,
  IXMLDOMNode** outOldChild
);

Remarks

C/C++ Parameters

• childNode
  [in] Child node to be removed from the list of children of this node.

• outOldChild
  [out, retval] Removed child node. If Null, no object is created.

C/C++ Return Values

• S_OK
  Value returned if successful.

• E_INVALIDARG
  Value returned if oldChild is not a child of this node, when the specified oldChild is read-only and cannot be removed, or when oldChild is Null.

• E_FAIL
  Value returned if an error occurs.

Requirements

General Remarks

This method applies to the following objects and interfaces:

IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, and IXTLRuntime.