Continue()

When fpConvertStream() or KVXMLConvertFile() is called, control is not returned to the application until the entire document is processed. This callback function provides a means of monitoring progress and terminating the conversion process before the conversion is completed.

Syntax

BOOL (pascal *Continue) (
    void     *pCallingContext, 
    int      nPercentComplete);

Arguments

pCallingContext

A pointer passed back to the caller-provided callback functions. This pointer, which can be NULL, is specified as the second parameter of the call to fpConvertStream() and KVXMLConvertFile().

nPercentComplete

The approximate percentage of the current conversion that is completed. You can monitor the progress of the conversion by checking this value, which indicates the percentage of blocks that have been processed.

Returns

  • To continue the conversion, return TRUE.
  • To terminate the conversion process without completing the conversion, return FALSE.

Discussion

  • There is a callback to this function for every entry that appears in the generated table of contents.

  • The application is free to execute any required code in the callback function, with the exception of fpShutDown().