DTWAIN_ArrayInsertAtStringN
|
DTWAIN_ArrayInsertAtStringN DTWAIN_ArrayInsertAtStringNA DTWAIN_ArrayInsertAtStringNW |
|
The DTWAIN_ArrayInsertAtStringN inserts N copies of a string into a DTWAIN_ARRAY.
DTWAIN_BOOL DTWAIN_ArrayInsertAtStringN (
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 string to insert.
NumCopies Number of copies of Value to add to the array. Return Values TRUE if successful, FALSE otherwise. If the function returns FALSE, call DTWAIN_GetLastError() to get extended information.
Character specific version
Comments DTWAIN_ArrayInsertAtStringN is a specialized version of the DTWAIN_ArrayInsertAtN function.
The DTWAIN_ArrayInsertAtStringN function inserts NumCopies of the 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.
Since this function requires an LPCTSTR, the type of string that can be stored will depend on whether the ANSI or Unicode version of the DTWAIN DLL is being used. If the ANSI version of the DLL is used (DTWAIN32.DLL, DTWAIN64.DLL), then the type of string stored will be ANSI, If the Unicode version of DTWAIN is used (DTWAIN32U.DLL, DTWAIN64U.DLL), the type of string will be a wide or Unicode string. For storing specifically ANSI or Wide strings, use DTWAIN_ArrayInsertAtANSIStringN or DTWAIN_ArrayInsertAtWideStringN, respectively.
TWAIN State Transitions None.
Prerequisite Function Call(s)
See Also Adding, Setting, and Inserting elements in a DTWAIN_ARRAY
|