DTWAIN_ArrayAddANSIString
|
The DTWAIN_ArrayAddANSIString function adds a string value to the end of a DTWAIN_ARRAY.
DTWAIN_BOOL DTWAIN_ArrayAddANSIString (
Parameters Array DTWAIN_ARRAY that the value will be added to.
Value Pointer to character buffer.
Return Values TRUE if successful, FALSE otherwise. If the function returns FALSE, call DTWAIN_GetLastError() to get extended information.
Comments The DTWAIN_ArrayAddANSIString function appends the contents of the buffer located at Value to the end of the DTWAIN_ARRAY Array. The number of elements in the DTWAIN_ARRAY is increased by 1. DTWAIN_ArrayAddANSIString is a specialized version of DTWAIN_ArrayAdd for string values.
This function will only work for DTWAIN_ARRAY's that can store 8-bit ANSI 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 (Unicode) character strings, use DTWAIN_ArrayAddWideString.
TWAIN State Transitions None.
Prerequisite Function Call(s)
See Also |