flush Method (Windows Embedded CE 6.0)

1/6/2010

This method flushes the object's internal buffer to its destination IStream/String. Flushing occurs when one of the following three actions occur:

• There is access to the output property.
• The endDocument event is called.
• The flush method is called.

Syntax

HRESULT flush( );

Parameters

None.

Return Value

• S_OK
  Returned if no errors are reported.

Remarks

Avoid handling the underlying IStream object during output (for example, direct writing). Keep in mind that a correspondence between Simple API for XML (SAX2) events and output text is not generally specified, though an implementation can provide it. Therefore, when using the flush method, the exact position within the generated document is not generally known. If the flush method interrupts the IMXWriter output, all output that has been processed is put into the underlying IStream/ISequentialStream object.

Requirements

See Also

Reference

IMXWriter
output Property (XML SAX)