Share via

setNamedItem Method

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Adds the supplied node to the collection.

Script Syntax

var objXMLDOMNode = oIXMLDOMNamedNodeMap.setNamedItem(newItem);

Remarks

Script Parameters

  • newItem
    Object containing the attribute to be added to the collection.

Script Return Value

Object. Returns the attribute successfully added to the collection.

C/C++ Syntax

HRESULT setNamedItem(
  IXMLDOMNode* newItem,
  IXMLDOMNode** nameItem
);

Remarks

C/C++ Parameters

  • newItem
    [in] Attribute to be added to the collection.
  • nameItem
    [out, retval] Attribute successfully added to the collection. If Null, no object is created.

C/C++ Return Values

  • S_OK
    Value returned if successful.
  • E_INVALIDARG
    Value returned if newItem is Null.
  • E_FAIL
    Value returned if an error occurs.

Requirements

Header msxml2.h, msxml2.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

General Remarks

If an attribute already exists with the name in IXMLDOMNode, the supplied replaces the existing attribute. The attribute name appears in its IXMLDOMNode property.

If the newItem node type is not NODE_ATTRIBUTE, setNamedItem returns an error. For example, it is not possible to modify entities or notations, which are read-only.

This method applies to the following objects and interfaces:

IXMLDOMNode, and IXMLDOMNamedNodeMap.