DTWAIN_LoadLanguageResource

The DTWAIN_LoadLanguageResource loads one of the DTWAIN Language Resource DLL's for use by DTWAIN.

DTWAIN_BOOL DTWAIN_LoadLanguageResource (  LONG nLanguage );

Parameters

nLanguage

Specifies the DTWAIN Language Resource DLL to load.

Return Values

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

Comments

The DTWAIN_LoadLanguageResource function allows an application to load a specific DTWAIN Language Resource DLL.  The Language Resource DLL determines the language that the DTWAIN error strings returned from DTWAIN_GetErrorString will be displayed in.

The nLanguage must be one of the following:

The Resource DLL Name is the name of the resource DLL that contains all of the language strings used by DTWAIN.  This DLL must be available to the application before calling DTWAIN_LoadLanguageResource.  The language resource DLL's have the .L32 file name extension.

If DTWAIN_LoadLanguageResource is called multiple times, the currently used resource DLL is unloaded and the resource DLL specified by nLanguage is loaded.  This allows your application to dynamically change the resource strings without having to restart DTWAIN.

By default, the language that is always loaded is DTWAIN_RES_ENGLISH, unless there is an override specified in the DTWAIN32.INI file to specify a different language resource DLL to initially load.

If your language is not listed here, you can add any SBCS (Single Byte Character Set) language translation resource using the DTWAIN_LoadCustomStringResource function.

TWAIN State Transitions

None

Prerequisite Function Call(s)

DTWAIN_SysInitialize