GetAuxOutput()
This callback function enables the calling application to specify an auxiliary output stream for a block or graphic.
Syntax
BOOL (pascal *GetAuxOutput) (
void *pCallingContext,
KVHTMLAnchorTypeEx eAnchorTypeEx,
char *pszAnchor,
KVOutputStream *pNewOutput);
Arguments
|
|
A pointer passed back to the caller-provided callback functions. This pointer, which can be |
|
|
A graphic or block anchor as defined by the enumerated types in |
|
|
File Content Extraction will have set this to the anchor associated with this stream. pszAnchor is based on the call to GetAnchor(). |
|
|
A pointer to a |
Returns
- To continue the conversion, return
TRUE. - To terminate the conversion process without completing the conversion, return
FALSE.
Discussion
-
If
GetAuxOutput()isNULL, thepszDefaultOutputDirectorymember of the instance ofKVHTMLOptionsExis used as the base storage location for auxiliary output files. IfpszDefaultOutputDirectoryis alsoNULL, auxiliary files are placed in the current working directory. -
This function must fill out the provided stream function by setting an appropriate function for each member. Memory allocated to the I/O structure must be tracked and freed within the call to
Close().