IXMLDOMNode::cloneNode Method

Creates a new node that is an exact clone of this node.

Visual Basic Syntax

Set objXMLDOMNode = oXMLDOMNode.cloneNode(deep)

C/C++ Syntax

HRESULT cloneNode(
    VARIANT_BOOL deep,
    IXMLDOMNode **cloneRoot);

Parameters

deep [in]

Flag that indicates whether to recursively clone all nodes that are descendants of this node. If True, create a clone of the complete tree below this node. If False, clone this node and its attributes only.

cloneRoot [out]

Newly created clone node.

C/C++ Return Values

S_OK

Value returned if successful.

E_INVALIDARG

Value returned if cloneRoot is Null.

Remarks

The cloned node has the same property values as this node for the following properties: nodeName, nodeValue, nodeType, parentNode, ownerDocument, and (if it is an element) attributes. The value of the clone's childNodes collection depends on the setting of the deep parameter flag.

Note   If the node is the IXMLDOMDocument node, it is safer to clone the document using the save method, as follows:

doc.save(doc2);

See Also

IXMLDOMNode Interface