DTWAIN_SysInitializeLibEx2

Top Previous Next

The DTWAIN_SysInitializeLibEx2 function initializes the DTWAIN static libraries for use.

LONG DTWAIN_SysInitializeLibEx2 (

HINSTANCE	hInst,
LPCSTR	szINIPath,
LPCSTR	szImageDLLPath,
LPCSTR	szLangResourcePath );

Parameters

hInst

Instance handle of resource module.

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.

Comments

The DTWAIN_SysInitializeLibEx2 function does exactly the same as the DTWAIN_SysInitializeLib function, and allows more optional customization of the DTWAIN environment.

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.