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 parses the specified amount of XML (in characters).

Syntax

HRESULT Run( 
  long 
lChars
);

Parameters

lChars

[in] The amount of XML (in characters) to be parsed.

Return Value

The IXMLParser::Runmethod returns E_PENDING if it is not finished or S_OK when it reaches the end of the input. An amount of -1 means parse as much as it can get from the input stream. If the IXMLParser::PushDatamethod is being used, the IXMLParser::Runmethod returns E_PENDING until the last buffer is pushed; after that, it will return S_OK. The number given to IXMLParser::Runis just a hint. IXMLParser::Runwill still succeed even if the specified number of characters are not left in the input buffer.

If an asynchronous download was started, IXMLParser::Run(-1) will return E_PENDING; as long as the application has a message loop, the download and parsing will occur in the background as data becomes available from URLMON. IXMLParser::GetParserStatecan be checked periodically; at some point the parser will no longer return XMLPARSER_BUSY. To monitor the progress, use the IXMLParser::Loadmethod, register a new instance of IBindStatusCallback, and watch the IBindStatusCallback::OnProgresscalls.

Requirements

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

See Also

Reference

IXMLParser