Microsoft XML 2.5 SDK


 

IXMLDOMNode::get_firstChild Method

[This is preliminary documentation and subject to change.]

Contains the first child of this node.

Visual Basic Syntax

Set objXMLDOMNode = oXMLDOMNode.firstChild

C/C++ Syntax

HRESULT get_firstChild(

    IXMLDOMNode **firstChild);

Parameters

firstChild

[out]
First child node. If there are no such children, it returns NULL.

C/C++ Return Values

S_OK

Value returned if successful.

S_FALSE

Value when returning null.

E_INVALIDARG

Value returned if firstChild is null.

Remarks

This value depends on the value of the nodeType property.

NODE_ATTRIBUTE, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT, NODE_DOCUMENT_TYPE, NODE_ELEMENT, NODE_ENTITY, NODE_ENTITY_REFERENCE Returns the first child node. If there are no children, returns NULL.
NODE_CDATA_SECTION, NODE_COMMENT, NODE_NOTATION, NODE_PROCESSING_INSTRUCTION, NODE_TEXT Returns NULL. These node types cannot have children.