LTWAINTEMPLATECALLBACK Function

HTWAINSESSION hSession;

handle to an existing TWAIN session

pTW_CAPABILITY * pCapability;

pointer to a capability

L_INT nStatus;

indicates success or error code

L_VOID * pUserData;

pointer to additional parameters

Parameter

Description

hSession

Handle to an existing TWAIN session.

pCapability

Pointer to a TW_CAPABILITY structure that contains the capability.  For information on this structure, refer to www.twain.org and click on TWAIN Specification.

nStatus

When used with L_TwainLoadTemplateFile, nStatus refers to whether pCapability was set successfully.  When used with L_TwainSaveTemplateFile, nStatus refers to whether the pCapability was successfully added to the template file.

pUserData

A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of L_TwainLoadTemplateFile or L_TwainSaveTemplateFile.)

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

TWAIN_SUCCESS

The function was successful.

TWAIN_SUCCESS_ABORT

The callback wants to abort the operation.

< 1

An error occurred. Refer to Return Codes.

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.