DTWAIN_ArraySetAtFrame

The DTWAIN_ArraySetAtFrame places a DTWAIN_FRAME element in a DTWAIN_ARRAY.

DTWAIN_BOOL DTWAIN_ArraySetAtFrame (

DTWAIN_ARRAY	Array
LONG	Index
DTWAIN_FRAME	Value );

Parameters

Array

DTWAIN_ARRAY that the value will be placed.

Index

Position to place the element

Value

DTWAIN_FRAME value to be set in the DTWAIN_ARRAY.

Return Values

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

Comments

DTWAIN_ArraySetAtFrame is a specialized version of DTWAIN_ArraySetAt.

The DTWAIN_ArraySetAtFrame copies the value Value to a position in the DTWAIN_ARRAY Array. The Index argument is the position to place the value, and must be in the range of 0 to n-1 where n is the number of elements in the array.

This function will only work for DTWAIN_ARRAY's that can store DTWAIN_FRAME values (i.e. the DTWAIN_ARRAY was created with the DTWAIN_ARRAYFRAME style. See DTWAIN_ArrayCreate for more information).

TWAIN State Transitions

None.

Prerequisite Function Call(s)

DTWAIN_SysInitialize