IXMLParser::PushData

This method provides data to the parser by pushing the specified data as a raw buffer containing bytes.

Syntax

HRESULT PushData( 
  const char * pData,
  ULONG ulChars,
  BOOL fLastBuffer
);

Parameters

pData
[in] Pointer to the data to be pushed.
ulChars
[in] Size, in characters, of the data pointed to by pData.
fLastBuffer
[in] Indicates whether the current buffer is the last buffer.

Return Values

This function returns S_OK if the function is successful, otherwise an error code is returned.

Remarks

The lowest level way to provide input is as a raw buffer of bytes. The buffer is not NULL terminated. Call the IXMLParser::PushData method with each buffer. IXMLParser::Run will continue to return E_PENDING until IXMLParser::PushData is called with the fLastBuffer argument set to TRUE. An XML token can span multiple buffers.

For example, the first buffer might end with "<!— sample", in which case the parser will return E_PENDING; if the next buffer starts with "bar — ->", the parser will complete the token and call the IXMLNodeFactory interface with the combined COMMENT text "<! — -sampletag — ->".

When IXMLParser::PushData is called with fLastBuffer set to TRUE, the pushing of data should not continue unless the parser is reset first (the parser behavior is undefined otherwise).

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: xmlparser.h

Share via