Microsoft XML 2.5 SDK


 

IXMLDOMNode::get_attributes Method

[This is preliminary documentation and subject to change.]

Contains the list of attributes for this node.

Visual Basic Syntax

Set objXMLDOMNamedNodeMap = oXMLDOMNode.attributes

C/C++ Syntax

HRESULT get_attributes(

    IXMLDOMNamedNodeMap **attributeMap);

Parameters

attributeMap

[out]
NamedNodeMap returned for nodes that can return attributes (Element, Entity, and Notation nodes). Returns NULL for all other node types. Note that for the valid node types, the NamedNodeMap is always returned; when there are no attributes on the element, the list length is set to zero.

C/C++ Return Values

S_OK

Success. Returns a non-NULL pointer value.

S_FALSE

Success. Returns a NULL pointer value.

E_INVALIDARG

Value returned if attributeMap is NULL.

Remarks

This value depends on the value of the nodeType property.

NODE_ATTRIBUTE, NODE_CDATA_SECTION, NODE_COMMENT, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT, NODE_DOCUMENT_TYPE, NODE_ENTITY_REFERENCE, NODE_PROCESSING_INSTRUCTION, NODE_TEXT Always returns null.
NODE_ELEMENT Returns an IXMLDOMNamedNodeMap object that contains a list of nodes corresponding to the attributes of the element.
NODE_ENTITY, NODE_NOTATION Returns an IXMLDOMNamedNodeMap object that exposes PUBLIC ID, SYSTEM ID, and NDATA as attributes.