DTWAIN_GetSourceVersionInfo

Top  Previous  Next

The DTWAIN_GetSourceVersionInfo gets a Source's version information.

 

LONG DTWAIN_GetSourceVersionInfo (

DTWAIN_SOURCE

Source,

LPTSTR

szBuffer

LONG

Maxlen );

 

Parameters

Source

Specifies a TWAIN Source.

 

szBuffer

Specifies the address of the character buffer to store the version information or NULL.

 

MaxLen

Specifies the maximum number of characters to copy to szBuffer.

 

 

Return Values

If the function succeeds, the number of characters copied to szBuffer is returned.  If the function fails, DTWAIN_FAILURE1 is returned.

 

Character specific version

ANSI version:

DTWAIN_GetSourceVersionInfoA

Unicode version:

DTWAIN_GetSourceVersionInfoW

 

Comments

The DTWAIN_GetSourceVersionInfo function fills szBuffer with the Version Information associated with the Source Source The MaxLen argument is the maximum number of characters to copy to szBuffer, including the trailing null character.

 

If szBuffer is NULL, the length of the version information, plus 1 for the trailing NULL, is returned.  The MaxLen argument is ignored and no characters are copied to szBuffer. You can use this method to determine the total number of characters needed to store the version information.

 

TWAIN State Transitions

None.

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

Either of these functions can be used to get the Source:

DTWAIN Source Selection Function

or

DTWAIN_EnumSources

 

See Also

Source Information Functions