Oracle C++ Call Interface Programmer's Guide

Statement Class
Note that not all types can be supplied in the buffer. For example, all OCCI
allocated types (such as Bytes, Date and so on.) cannot be provided by the
setDataBuffer interface. Similarly, C++ Standard Library strings cannot be
provided with the setDataBuffer interface either. The type can be any of OCI
data types such VARCHAR2, CSTRING, CHARZ and so on.
If setDataBuffer() is used to specify data for iterative or array executes, it
should be called only once in the first iteration only. For subsequent iterations,
OCCI would assume that data is at buffer + i*size location where i is the
iteration number. Similarly the length of the data would be assumed to be at
*(length + i).
Syntax
void setDataBuffer(unsigned int paramIndex,
void *buffer,
Type type,
sb4 size,
ub2 *length,
sb2 *ind = NULL,
ub2 *rc= NULL);
Parameters
paramIndex
The first parameter is 1, the second is 2, . . . .
buffer
Pointer to user-allocated buffer; if iterative or array executes are done, it should
have numIterations * size bytes in it.
type
Type of the data that is provided (or retrieved) in the buffer
size
Size of the data buffer; for iterative and array executes, it is the size of each element
of the data items
length
Pointer to the length of data in the buffer; for iterative and array executes, it should
be an array of length data for each buffer element; the size of the array should be
equal to arrayLength.
OCCI Classes and Methods 8-195