firstChild Property

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Contains the first child of the node.

Script Syntax

var objXMLDOMNode = oXMLDOMNode.firstChild;

Remarks

Script Parameters

None.

Script Return Value

Object. Returns the first child node. If there are no such children, returns Null.

C/C++ Syntax

HRESULT get_firstChild(
  IXMLDOMNode** firstChild
);

Remarks

C/C++ Parameters

  • firstChild
    [out, retval] 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 returned when there are no children.
  • E_INVALIDARG
    Value returned if firstChild is Null.

Requirements

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

General Remarks

This value depends on the value of the nodeType property.

Value Description

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.

This property is read-only, and applies to the following objects and interfaces:

IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, IXTLRuntime

See Also

Concepts

nodeType Property