LTwain::CapabilityCallBack

Summary

Handles each capability enumerated by the LTwain::EnumCapabilities function.

Syntax

virtual L_INT LTwain::CapabilityCallBack (uCap, pCapability)

Parameters

L_UINT uCap

The capability being enumerated. For more information on capability values, refer to the TWAIN specification.

pTW_CAPABILITY pCapability

Pointer to the TW_CAPABILITY structure that references the capability data being enumerated. For more information about TW_CAPABILITY, refer to the TWAIN specification.

Returns

Comments

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

To prevent memory leaks, free the pointer to the TW_CAPABILITY structure within the callback function.

This structure can be freed by a call to LTwain::FreeContainer then you can free the pointer using GlobalFreePtr macro defined in Windows.h.

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::EnumCapabilities.

Topics

• TWAIN Functionality: Callback Functions

Example

For an example, refer to LTwain::AddCapabilityToFile.