This function converts either a source stream or file to an output stream.
BOOL pascal fpConvertStream( void *pContext, void *pCallingContext, KVInputStream *pInput, KVOutputStream *pOutput, KVXMLTemplate *pTemplates, KVXMLOptions *pOptions, KVXMLTOCOptions *pTOCCreateOptions, KVXMLCallbacks *pCallbacks, BOOL bIndex, KVErrorCode *pError );
pContext
|
A pointer returned from fpInit() or fpInitWithLicenseData(). |
pCallingContext
|
A pointer passed back to the callback functions. |
pInput
|
A pointer to the developer-assigned instance of KVInputStream . The KVInputStream structure defines the input stream that contains the source for the conversion. See KVInputStream. |
pOutput
|
A pointer to the developer-assigned instance of KVOutputStream . The KVOutputStream structure defines the output stream to which Export writes the generated HTML. See KVOutputStream. |
pTemplates
|
A pointer to the If this pointer is |
|
A pointer to the KVXMLOptions data structure. It defines the options that control the markup written in response to the general style and attributes (font, color, and so on) of the document. If this pointer is |
|
A pointer to the If callbacks are not used, this can be |
|
A pointer to the If this pointer is |
Set You can set this option through the To generate output with verbose markup and without images, set the |
|
pError
|
A pointer to an error code if the call to fpConvertStream() fails. |
If the call is successful, the return value is TRUE
.
If the call is unsuccessful, the return value is FALSE
.
Only pContext
, pInput
, pOutput
, and bIndex
are required. All other pointers should be NULL
when they are not set.
If pCallbacksEx
is NULL
, pOptionsEx->pszDefaultOutputDirectory
must be valid, except when bIndex
is set 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()
.
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().
The following sample code is from the cnv2xml
sample program:
if(!(*KVXMLInt.fpConvertStream)( pKVXML, /* A pointer returned by fpInit() */ NULL, /* A pointer for callback functions */ &Input, /* Input stream */ &Output, /* Output stream */ NULL, /* 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]); }
|