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

DTWAIN_EnumSources