Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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_INFOstructure 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.

Copy Code
<sample name="123">

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

Copy Code
<sample name="123"/>

The Boolean argument fEmptywill indicate whether a node was empty at IXMLNodeFactory::EndChildrentime.

Requirements

Header xmlparser.h
Library xmlparser.lib
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also