LTwain::SetPropertyCallBack

#include "ltwrappr.h"

virtual L_INT LTwain::SetPropertyCallBack (uCap, nStatus, pValue)

L_UINT uCap;

/* capability being set */

L_INT nStatus;

/* status variable */

L_VOID * pValue;

/* pointer to the original value */

Called for each property set using LTwain::SetProperties.

Parameter

Description

uCap

The capability being set. For more information on capability values, refer to the Twain 1.9 Specification, available at www.twain.org.

nStatus

This variable holds the value of the error that occurred while the property was being set.

pValue

Pointer to the original value. The user can cast this depending on the type of the property, and modify it.

Returns

SUCCESS

The function was successful.

SUCCESS_RETRY

Retry with the new value in *pValue parameter.

SUCCESS_ABORT

Abort the negotiation.

Comments

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

The user should not free the pValue parameter 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::SetProperties.

Topics:

TWAIN Functionality: Callback Functions

Example

For an example, refer to LTwain::GetProperties.