setAttributeNode Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Sets or updates the supplied attribute node on this element.

Script Syntax

var objXMLDOMAttribute = oXMLDOMElement.XMLDOMElement(DOMAttribute);

Remarks

Script Parameters

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

Script Return Value

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++ Syntax

HRESULT setAttributeNode(
  IXMLDOMAttribute* DOMAttribute,
  IXMLDOMAttribute** attributeNode
);

Remarks

C/C++ Parameters

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

C/C++ Return Values

• S_OK
  Value returned if successful.

• E_FAIL
  Value returned if an error occurs.

Requirements

General 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.

See Also

Other Resources