DTWAIN_OpenSourcesOnSelect

Top  Previous  Next

The DTWAIN_OpenSourcesOnSelect allows DTWAIN to either open or not open TWAIN Sources once selected.

 

DTWAIN_BOOL DTWAIN_OpenSourcesOnSelect ( DTWAIN_BOOL bOpenSources );

 

Parameters

bOpenSources

   Specifies whether TWAIN Sources will be opened when they are selected.

 

Return Values

If the function succeeds, TRUE is returned.  If unsuccessful, FALSE is returned.

 

Comments

DTWAIN_OpenSourcesOnSelect allows DTWAIN to open or not open Sources when they are selected with one of the Source Selection Functions*


If bOpenSources is TRUE, any Source that is selected will be automatically opened.  If bOpenSources is FALSE, the application must call DTWAIN_OpenSource to explicitly open any Source. 

Opening a Source allows DTWAIN to negotiate the capabilities of the Source, plus other operations that will only work for Sources that are opened.


* Please note that the following source selection functions can be used to override the setting set by DTWAIN_OpenSourcesOnSelect():


DTWAIN_SelectSourceWithOpen

DTWAIN_SelectSourceByNameWithOpen

DTWAIN_SelectDefaultSourceWithOpen