LEADTOOLS TWAIN C++ Class Library Help
| LEADTOOLS TWAIN C++ Class Library Help > Classes and Function References > LTwain > LTwain Class Members > LTwain::CapabilityCallBack |
#include "ltwrappr.h"
virtual L_INT LTwain:: CapabilityCallBack (uCap, pCapability)
|
L_UINT uCap; |
/* capability received */ |
|
pTW_CAPABILITY * pCapability; |
/* pointer to a structure */ |
Handles each capability enumerated by the LTwain::EnumCapabilities function.
|
Parameter |
Description |
|
uCap |
The capability being enumerated. For more information on capability values, refer to the Twain 1.9 Specification, available at www.twain.org. |
|
pCapability |
Pointer to the TW_CAPABILITY structure that references the capability data being enumerated. 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. |
|
< 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).
To prevent memory leaks, the user should free the pointer to 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: |
|
|
Topics: |
Example
For an example, refer to LTwain::AddCapabilityToFile.
