IXMLNodeFactory::BeginChildren

4/8/2010

This method is called when a node can contain children.

Syntax

HRESULT BeginChildren( 
  IXMLNodeSource * pSource,
  XML_NODE_INFO * pNodeInfo
);

Parameters

• pSource
  [in] The node source is passed into each node factory call so that the node factory can call back and obtain important information, such as the current line number, or stop the parser

• pNodeInfo
  [in] Pointer to an XML_NODE_INFO structure that contains the information about the node to be processed

Return Value

This function should return S_OK if the function succeeds. Otherwise, an error code can be returned and the parsing will stop.

Remarks

The following example node can contain children.

<sample name="123">

Nodes that are empty, such as comment, CDATA, and text nodes, will not have a IXMLNodeFactory::BeginChildren call.

<sample name="123"/>

The Boolean argument fEmpty will indicate whether a node was empty at IXMLNodeFactory::EndChildren time.

Requirements

See Also

Reference

IXMLNodeFactory
IXMLNodeFactory::EndChildren
XML_NODE_INFO