|Oracle Call Interface Programmer's Guide
Part Number A89857-01
OCI Navigational and Type Functions, 27 of 36
Pins an array of references.
sword OCIObjectArrayPin ( OCIEnv *env, OCIError *err, OCIRef **ref_array, ub4 array_size, OCIComplexObject **cor_array, ub4 cor_array_size, OCIPinOpt pin_option, OCIDuration pin_duration, OCILockOpt lock, dvoid **obj_array, ub4 *pos );
The OCI error handle. If there is an error, it is recorded in
err and this function returns OCI_ERROR. Obtain diagnostic information by calling
Array of references to be pinned
Number of elements in the array of references
An array of COR handles corresponding to the objects being pinned.
The number of elements in
Pin duration. See
Lock option. See
If this argument is not null, the pinned objects will be returned in the array. The user must allocate this array with element type being dvoid *. The size of this array is identical to
If there is an error, this argument indicates the element that is causing the error. Note that this argument is set to 1 for the first element in the
All the pinned objects are retrieved from the database in one network roundtrip. If the user specifies an output array (
obj_array), then the address of the pinned objects will be assigned to the elements in the array.