This function converts either a source stream or file to an output stream.
BOOL pascal fpConvertStream( void *pContext, void *pCallingContext, KVInputStream *pInput, KVOutputStream *pOutput, KVHTMLTemplateEx *pTemplatesEx, KVHTMLOptionsEx *pOptionsEx, KVHTMLCallbacksEx *pCallbacksEx, KVHTMLTOCOptions *pTOCCreateOptions, 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 KVHTMLOptionsEx 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 also set this option through the bNoPictures member in the template files. |
|
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 KVHTMLStartOOPSession()
and before the call to KVHTMLEndOOPSession()
.
When converting out of process, the values for the KVHTMLTemplateEx
, KVHTMLOptionsEx
, and KVHTMLTOCOptions
structures should be set to NULL
. These structures are already passed in the call to KVHTMLStartOOPSession()
. See KVHTMLStartOOPSession().
The following sample code is from the cnv2html
sample program:
if(!(*KVHTMLInt.fpConvertStream)( pKVHTML, /* A pointer returned by fpInit() */ NULL, /* A pointer for callback functions */ &Input, /* Input stream */ &Output, /* Output stream */ &HTMLTemplates, /* Markup and related variables */ &HTMLOptions, /* Options */ NULL, /* A pointer to callback functions */ NULL, /* TOC options */ FALSE, /* Index mode */ &error)) /* Error return value */ { printf("Error converting %s to HTML %d\n", argv[i - 1], error); } else { printf("Conversion of %s to HTML completed.\n\n", argv[i - 1]); }