fpGetConvertFileList()

This function gets the list of files automatically converted to XML during a call to fpConvertStream() or KVXMLConvertFile().

Syntax

char ** pascal _export fpGetConvertFileList( 
    void    *pContext,
    int     *pnSize );

Arguments

pContext

A pointer to a KeyView Export session that you initialized by calling fpInit().

pnSize

A pointer to the number of files generated by the conversion.

Returns

If no files are converted, the return value is a NULL pointer. Otherwise, the return value is a pointer to an array of strings that provides the available path information for each converted file.

Discussion

  • The array of file path information includes all externally generated files, including graphic files. Note that the main output file is not included in the array, nor in the count of the number of files converted.

  • The memory used by the array of file path information is freed by the API.

  • The array is not valid after a call to fpShutDown().

  • This function runs in-process or out of process. See Convert Files Out of Process.

  • When converting out of process, this function must be called after the call to KVXMLStartOOPSession() and before the call to KVXMLEndOOPSession(). See KVXMLStartOOPSession() and KVXMLEndOOPSession().