DTWAIN_SysInitializeEx2

Top  Previous  Next

The DTWAIN_SysInitializeEx2 function initializes the DTWAIN DLL for use with the application.

 

LONG DTWAIN_SysInitializeEx2 (

LPCTSTR

szINIPath,

LPCTSTR

szImageDLLPath,

LPCTSTR

szLangResourcePath );

 

Parameters

szIniPath

  Path where DTWAIN32.INI is installed or NULL.

 

szImageDLLPath

  Path where DTWIMG32.DLL is installed or NULL.

 

szIniPath

  Path where language DLL (*.L32) file is installed or NULL

 

Return Values

If the function succeeds, a non-zero value is returned.  If the function fails, zero (0) is returned.

 

Character specific version

ANSI version:

DTWAIN_SysInitializeEx2A

Unicode version:

DTWAIN_SysInitializeEx2W

 

Comments

The DTWAIN_SysInitializeEx2 function does exactly the same as the DTWAIN_SysInitialize function.  The szINIPath is the path of where the DTWAIN32.INI file is stored.  By default, the DTWAIN32.INI file must be located in the Windows system directory, however DTWAIN_SysInitializeEx gives you the flexibility to store the DTWAIN32.INI file in any accessible directory.

 

A description of the DTWAIN32.INI file and customization can be found here.

 

The szImageDLLPath is the path of where the DTWIMG32.DLL is located.  The DTWIMG32.DLL file is required if acquiring images to TIFF, PNG, PDF, JPEG, or PostScript.  By default, the DTWIMG32.DLL is found either in the application's directory, or a directory specified by the PATH environment variable.

 

Please note: As of version 2.3.0.0 of DTWAIN, the DTWIMG32.DLL is no longer necessary to acquire to TIFF, PNG, PDF, JPEG, or PostScript files.  Therefore the szImageDLLPath argument will be ignored if using DTWAIN version 2.3.0.0 or above.

 

The szLangResourcePath is the path of where the resource DLL are found (The resource DLL's have the L32 extension).  By default, the resource DLL's are found either in the application's directory, or a directory specified by the PATH environment variable.

 

A NULL value for either szIniPath, szImageDLLPath, or szLangResourcePath indicates that the parameter is to be ignored.

 

 

TWAIN State Transitions

State 1

 

Prerequisite Calls

None.

 

Optional Prerequisite Calls

None.

 

See Also

DTWAIN_SysDestroy, DTWAIN_IsTwainAvailable, DTWAIN_IsInitialized