DTWAIN_LoadLanguageResource

Top  Previous  Next

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:

 

nLanguage Value

Resource DLL Name



DTWAIN_RES_ENGLISH

DTWENG.L32

DTWAIN_RES_FRENCH

DTWFRA.L32

DTWAIN_RES_SPANISH

DTWSPA.L32

DTWAIN_RES_DUTCH  

DTWDTC.L32

DTWAIN_RES_GERMAN

DTWDEU.L32

DTWAIN_RES_ITALIAN  

DTWITA.L32

 

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