This function is called directly and converts a source file to an output file.
BOOL pascal KVXMLConvertFile ( void *pContext, void *pCallingContext, char *pInFileName, char *pOutFileName, KVXMLTemplate *pTemplates, KVXMLOptions *pOptions, KVXMLTOCOptions *pTOCCreateOptions, KVXMLCallbacks *pCallbacks, BOOL bIndex, KVErrorCode *pError)
|
A pointer returned from fpInit() or fpInitWithLicenseData(). |
|
A pointer passed back to the callback functions. |
|
A pointer to the input file. |
|
A pointer to the output file. |
|
A pointer to the data structure If this pointer is |
|
A pointer to the data structure If this pointer is |
|
A pointer to the If this pointer is |
|
A pointer to the If callbacks are not used, this can be |
Set This can also be set through the |
|
|
A pointer to an error code if the call to |
If the call is successful, the return value is TRUE
.
If the call is unsuccessful, the return value is FALSE
.
Only pContext
, pInFileName
, pOutFileName
, and bIndex
are required. All other pointers should be NULL
when they are not set.
If pCallbacks
is NULL
, pOptions->pszDefaultOutputDirectory
must be valid, except when you set bIndex
to TRUE
.
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().
When converting out of process, the values for the KVXMLTemplate
, KVXMLOptions
, and KVXMLTOCOptions
structures should be set to NULL
. These structures are already passed in the call to KVXMLStartOOPSession()
. See KVXMLStartOOPSession().
if(!(*KVXMLInt.KVXMLConvertFile)( pKVXML, /* Pointer returned by fpInit() */ NULL, /* Pointer for callback functions */ &InputFile, /* Input file */ &OutputFile, /* Output file */ &XMLTemplates, /* Markup and related variables */ &XMLOptions, /* Options */ NULL, /* TOC options */ NULL, /* A pointer to callback functions */ FALSE, /* Index mode */ &error)) /* Error return value */ { printf("Error converting %s to XML %d\n", argv[i - 1], error); } else { printf("Conversion of %s to XML completed.\n\n", argv[i - 1]); }
|