KeyView 23.4

# 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,
        KVXMLAnchorType          eAnchorType,
        char                    *pszAnchor,
        KVOutputStream          *pNewOutput);

## Arguments

`pCallingContext` | A pointer passed back to the caller-provided callback functions. This pointer, which can be `NULL`, is specified as the second parameter of the call to `fpConvertStream()`.
`eAnchorType` | A graphic or block anchor as defined by the enumerated types in `KVXMLAnchorType`.
`pszAnchor` | KeyView will have set this to the anchor associated with this stream. `pszAnchor` is based on the call to `GetAnchor()`.
`pNewOutput` | A pointer to a `KVOutputStream` structure that can be used to write data to the current block.

## Returns

- To continue the conversion, return `TRUE`.
- To terminate the conversion process without completing the conversion, return `FALSE`.

## Discussion

- If `GetAuxOutput()` is `NULL`, the `pszDefaultOutputDirectory` member of the instance of `KVXMLOptions` is used as the base storage location for auxiliary output files. If `pszDefaultOutputDirectory` is also `NULL`, 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()`.

Copyright 1997-2023 Open Text
Version 23.4 | Last updated September 2023

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL KeyView 23.4

Topic Title: GetAuxOutput()