DTWAIN_SetPrinterStrings

Top  Previous  Next

The DTWAIN_SetPrinterStrings function sets the current imprinter/endorser strings.

 

DTWAIN_BOOL DTWAIN_SetPrinterStrings (

DTWAIN_SOURCE

Source,

DTWAIN_ARRAY

StringArray,

LPLONG

pNumStrings );

 

Parameters

Source

An open TWAIN Source.

 

StringArray

DTWAIN_ARRAY containing the strings to set for the printer.

 

pNumStrings

A pointer to a LONG variable that will be filled with the number of stirngs successfully set, or NULL.

 

Return Values

The return value is TRUE if successful.  Otherwise FALSE is returned.

 

Comments

The DTWAIN_SetPrinterStrings function sets the current imprinter/endorser strings for the Source Source.   The DTWAIN_ARRAY elements on return must be of type DTWAIN_STRING.

If DTWAIN_GetPrinterStringMode indicates that the current mode is DTWAIN_PM_MULTISTRING, the number of elements in the DTWAIN_ARRAY will be usually greater than 1.  On return pNumStrings will contain the number of strings that were set.  If pNumStrings is NULL, this argument is ignored.

 

TWAIN State Transitions

The Source must be in State 4. or higher

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

DTWAIN Source Selection Function

 

 

See Also

Imprinter / Endorser Support