IDOMDocument::createAttribute Method

Creates a new attribute with the specified name.

Syntax

HRESULT createAttribute(
    BSTR name,
    IDOMAttribute ** attribute);

Parameters

name

[in] Name of the new attribute object. This name is subsequently available as the new node's nodeName property.

attribute

[out] Address of the new IDOMAttribute object.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

No data value is set for the attribute during the create operation. You can set the value by calling the element object's setAttribute method.
Although this method creates the new object in the context of this document, this method does not automatically add the new object to the document tree. In other words, although the ownerDocument property of the new node points to this document object, the parentNode property is set to NULL. To associate the attribute with an element, call the IDOMElement object's setAttribute method.
Note that you cannot specify a namespace within the name parameter. If the name is specified in the form xxx:yyy, the special meaning of the colon is ignored and the attribute is created in the namespace of the document with the base name xxx:yyy and no namespace prefix. The nameSpace property, which contains the namespace URI, is set to the empty string, "".
The nodeType property has the value NODE_ATTRIBUTE.