DTWAIN_GetSourceManufacturer

Top Previous Next

The DTWAIN_GetSourceManufacturer gets a Source's manufacturers name.

LONG DTWAIN_GetSourceManufacturer (

DTWAIN_SOURCE	Source,
LPTSTR	szBuffer
LONG	Maxlen );

Parameters

Source

Specifies a TWAIN Source.

szBuffer

Specifies the address of the character buffer to store manufacture name 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_GetSourceManufacturerA
Unicode version:	DTWAIN_GetSourceManufacturerW

Comments

The DTWAIN_GetSourceManufacturer function fills szBuffer with the manufacturer's name associated with the Source Source The Maxlen argument is the maximum number of characters to copy to szBuffer, including the trailing null character. For example, if you want to return a maximum of 10 visible characters, the MaxLen argument should be 11 (one more to store the terminating NULL).

If szBuffer is NULL, the length of the manufacturer's name, 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 entire name.

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