DTWAIN_ArrayInsertAtANSIString

Top  Previous  Next

The DTWAIN_ArrayInsertAtANSIString inserts an ANSI (8-bit character) string into a DTWAIN_ARRAY.

 

DTWAIN_BOOL DTWAIN_ArrayInsertAtANSIString (

DTWAIN_ARRAY

Array

LONG

Index

LPCSTR

Value );

 

Parameters

Array

DTWAIN_ARRAY that the value will be inserted into.

 

Index

Position to place the inserted value

 

Value

A pointer to a null-terminated wide string to insert.

 

Return Values

If the function succeeds, TRUE is returned.  If the function fails FALSE is returned.

 

 

Comments

DTWAIN_ArrayInsertAtANSIString is a speicalized version of the DTWAIN_ArrayInsertAt function.

 

The DTWAIN_ArrayInsertAtANSIString function inserts the ANSI string pointed to by Value in the DTWAIN_ARRAY Array.  The Index argument is the position to insert the value.  The value is inserted before the value located at position Index.  The Index argument is numbered from 0 (the first position) to any positive number.

 

This function will only work for DTWAIN_ARRAY's that can store ANSI or 8-bit character strings values.  The DTWAIN_ARRAY must be created  with

 

1) The DTWAIN_ARRAYANSISTRING style

or

2) with the DTWAIN_ARRAYSTRING style if using the ANSI version of the DTWAIN library (DTWAIN32.DLL, DTWAIN64.DLL).

 
To insert 16-bit or Unicode character strings, use DTWAIN_ArrayInsertAtWideString.

 

TWAIN State Transitions

None.

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

See Also

Adding, Setting, and Inserting elements in a DTWAIN_ARRAY