Share via


IXMLNodeSource

4/8/2010

The IXMLNodeSource interface is defined as a base class for the IXMLParser so that other components can drive an IXMLNodeFactory interface without having to implement the full IXMLParser interface. For example, the IXMLNodeSource interface can drive an instance of IXMLNodeFactory from a component that extracts the data out of a database.

If an instance of the IXMLNodeFactory interface requires methods not defined here but in IXMLParser, it must use QueryInterface on IXMLParser to see whether it is really being driven by a parser or not (otherwise, this process must fail gracefully).

The following table shows the methods of the IXMLNodeSource interface, with a description of the purpose of each.

Method Description

IXMLNodeSource::Abort

Stops the IXMLNodeSource interface

IXMLNodeSource::GetAbsolutePosition

Returns the absolute offset from the beginning of the input stream or buffer after UTF-8 decoding is applied

IXMLNodeSource::GetErrorInfo

Returns a BSTR value that contains more descriptive information about the error (the same BSTR value that was provided to the IXMLNodeSource::Abort method)

IXMLNodeSource::GetFactory

Retrieves the IXMLNodeFactory interface specified by IXMLNodeSource::SetFactory

IXMLNodeSource::GetFlags

Sets the flags that can be combined by using OR to control how the parser works

IXMLNodeSource::GetLastError

Returns the last HRESULT that was returned from other methods

IXMLNodeSource::GetLineBuffer

Returns the current line of XML that is being parsed

IXMLNodeSource::GetLineNumber

Obtains the current line number of the XML that is being parsed

IXMLNodeSource::GetLinePosition

Obtains the current line number of the XML that is being parsed

IXMLNodeSource::GetURL

Returns the URL That Is Provided in the IXMLParser::SetURL or IXMLParser::Load methods for IXMLNodeSource interfaces that use IXMLParser

IXMLNodeSource::SetFactory

Plugs in a custom IXMLNodeFactory interface

Requirements

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

See Also

Reference

HTML Control API Interfaces