KeyView 24.4
KeyView XML Export SDK C Programming Guide

# fpGetOutputImageInfos()

This function returns the image information context that must be supplied to the `fpGetOutputImageCount()` or `fpGetOutputImageInfo()` functions. See fpGetOutputImageCount() and fpGetOutputImageInfo().

You must free the system resources associated with this context after you use it, by using the fpFreeImageInfos() function.

## Syntax

    void* pascal fpGetOutputImageInfos (
          void* const pContext,
          KVInputStream* const pInput,
          KVXMLOptions* const pOptions)

## Arguments

`pContext` | A pointer to a KeyView Export session that you initialized by calling fpInit().
`pInput` | The pointer to a `KVInputStream` instance. This instance defines the input stream that the function processes to extract the images.
`pOptions` | A pointer to a `KVXMLOptions` data structure. Functions using the context obtained with this method will report the dimensions of the images which would be obtained if this options structure were used for XML export. See KVXMLOptions. This pointer must not be `NULL`.

## Returns

- If the call is successful, the return value is the pointer to an image info context object.

- If the call is unsuccessful, the return value is `NULL`.

## Discussion

- To obtain image information out-of-process, call `KVXMLStartOOPSession()` before you call `fpGetOutputImageInfos()`. You must open a new, second OOP session for any subsequent XML export from the input stream.
- If this function fails, you can call fpGetKvErrorCode() to help identify the cause of the failure.
- You can use multiple image info contexts at any one time.

Copyright 1997-2024 Open Text
Version 24.4 | Last updated September 2024

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 MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL KeyView 24.4

Topic Title: fpGetOutputImageInfos()