setAttributeNode Method (Compact 2013)

3/26/2014

Sets or updates the supplied attribute node on this element.

Syntax

var objXMLDOMAttribute = oXMLDOMElement.XMLDOMElement(DOMAttribute);
HRESULT setAttributeNode(
  IXMLDOMAttribute* DOMAttribute,
  IXMLDOMAttribute** attributeNode
);

Parameters

Script

  • DOMAttribute
    Object that contains the attribute node to be associated with this element.

C/C++

  • DOMAttribute
    [in] Attribute node that is to be associated with this element.
  • attributeNode
    [out, retval] Null unless the new attribute replaces an existing attribute with the same name, in which case this method returns the previous, replaced attribute node.

Return Value

Script

Object. Returns Null unless the new attribute replaces an existing attribute with the same name, in which case this method returns the previous, replaced attribute node.

C/C++

  • S_OK
    Value returned if successful.
  • E_FAIL
    Value returned if an error occurs.

Remarks

You cannot add an existing attribute to an element until you first remove it from its previous element. Also, you cannot add a namespace-qualified attribute when it uses the same prefix as another attribute with a different namespaceURI Property (IXMLDOMNode)

This method applies to the following objects and interfaces:

IXMLDOMElement.

Requirements

Header

msxml2.h,
msxml2.idl

Library

uuid.lib

See Also

Reference

XML DOM Methods