L_TwainFreeScanConfig

#include "lttw2.h"

L_INT EXT_FUNCTION L_TwainFreeScanConfig(hSession, ppFastConfig, nFastConfigCount)

HTWAINSESSION hSession;

/* handle to an existing TWAIN session */

pFASTCONFIG *ppFastConfig;

/* address of a pointer to a FASTCONFIG structure */

L_INT nFastConfigCount;

/* number of array elements */

Frees storage allocated for a scan configuration array. This function is available in the Document/Medical Toolkits.

Parameter

Description

hSession

Handle to an existing TWAIN session. This handle is obtained by calling the L_TwainInitSession function.

ppFastConfig

Address of the pointer to the array of FASTCONFIG structures. This function will free the array of FASTCONFIG structures allocated by L_TwainFindFastConfig and L_TwainGetScanConfigs.

nFastConfigCount

Number of array elements to free.

Returns

SUCCESS

The function was successful.

! = SUCCESS

An error occurred. Refer to Return Codes.

Comments

Call this function to free the memory allocated by the L_TwainFindFastConfig and L_TwainGetScanConfigs functions.

This function should be called when your program no longer needs the array of FASTCONFIG structures.

Required DLLs and Libraries

LTTWN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_TwainAcquire, L_TwainAcquireList, L_TwainInitSession, L_TwainEndSession, L_TwainOpenTemplateFile, L_TwainCloseTemplateFile, L_TwainTemplateDlg, L_TwainAddCapabilityToFile, L_TwainGetNumofCapsInFile, L_TwainGetCapabilityFromFile, L_TwainAcquireMulti, L_TwainFindFastConfig, L_TwainGetScanConfigs

Topics:

Fast TWAIN (Scan Configurations)

 

TWAIN Functionality: Fast TWAIN (Scan Configuration) Functions.

Example

For a complete sample, refer to the TWNCONFIG demo.

For an example, refer to L_TwainFindFastConfig.