L_TwainSelectSource

#include "lttw2.h"

L_INT EXT_FUNCTION L_TwainSelectSource (hSession, pltSource)

HTWAINSESSION hSession;

/* handle to an existing TWAIN session */

pLTWAINSOURCE pltSource;

/* pointer to a structure */

Displays the TWAIN dialog box to be used to select a TWAIN source for acquiring images.

Parameter

Description

hSession

Handle to an existing TWAIN session. This handle is obtained by calling the L_TwainInitSession function.

pltSource

Pointer to a structure that contains the name of the TWAIN source to select.

Returns

SUCCESS

The function was successful.

! = SUCCESS

An error occurred. Refer to Return Codes.

Comments

Pass NULL for the pltSource parameter to display the default Twain Select Source dialog provided by the Twain Working Group. This allows the user to select the Twain device from the default Twain Select Source dialog. To select a device programmatically, set LTWAINSOURCE.pszTwainSourceName equal to the name of the desired device and then pass the address of the LTWAINSOURCE structure for the pltSource parameter.

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:

L_TwainGetSources, L_TwainInitSession, L_TwainEndSession.

Topics:

Managing the TWAIN Source

 

TWAIN Functionality: Property Functions.

Example

For an example, refer to L_TwainAcquire.