LTwain::SaveCapCallBack

#include "ltwrappr.h"

virtual L_INT LTwain::SaveCapCallBack (pCapability)

pTW_CAPABILITY pCapability;

/* pointer to a structure */

Called by LTwain::TemplateDlg for each capability supported by a particular TWAIN source, before saving it to a specific template file.

Parameter

Description

pCapability

Pointer to the TW_CAPABILITY structure that references the capability data to save to the specified template file. For more information about TW_CAPABILITY, refer to the TWAIN 1.9 specification from the site http://www.twain.org/.

Returns

SUCCESS

The function was successful.

SUCCESS_ABORT

The callback wants to abort the saving procedure.

SUCCESS_DELETE

Abort saving procedure and delete the file.

< 1

An error occurred. Refer to Return Codes.

Comments

This callback function will be enabled only if you enabled the callback functions by calling LBase::EnableCallBack(TRUE).

The user can only modify the capability data before saving it to the specified template file.

The user should not free the pointer to the TW_CAPABILITY structure within this callback.

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:

LTwain::TemplateDlg.

Topics:

TWAIN Functionality: Callback Functions.

Example

For an example, refer to LTwain::TemplateDlg.