DTWAIN_SysInitializeEx2
|
The DTWAIN_SysInitializeEx2 function initializes the DTWAIN DLL for use with the application.
LONG DTWAIN_SysInitializeEx2 (
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
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
Prerequisite Calls None.
Optional Prerequisite Calls None.
See Also DTWAIN_SysDestroy, DTWAIN_IsTwainAvailable, DTWAIN_IsInitialized |