cloneNode Method (Windows CE 5.0)

Send Feedback

Clones a new node.

[Script]

Script Syntax

var objXMLDOMNode = oXMLDOMNode.cloneNode(deep);

Script Parameters

  • deep
    Boolean. 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.

Script Return Value

Object. Returns the newly created clone node.

[C/C++]

C/C++ Syntax

HRESULT cloneNode(VARIANT_BOOLdeep,IXMLDOMNode** cloneRoot);

C/C++ 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, retval] Newly created clone node.

C/C++ Return Values

  • S_OK
    Value returned if successful.
  • E_INVALIDARG
    Value returned if cloneRoot is Null.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Msxml2.h, Msxml2.idl.
Link Library: Uuid.lib.

General 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 depends on the setting of the deep flag parameter.

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

doc.save(doc2);

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.

See Also

nodeName Property | nodeValue Property | nodeType Property | parentNode Property | ownerDocument Property | attributes Property | childNodes Property

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.