|Oracle Call Interface Programmer's Guide
Release 2 (9.2)
Part Number A96584-01
OCI Navigational and Type Functions, 9 of 36
Marks a persistent object as updated, or dirty.
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
A pointer to the persistent object, which must already be pinned.
This function marks a persistent object as updated, or dirty. The following special rules apply to different types of objects. The dirty status of an object may be checked by calling
This function marks the specified persistent object as updated.
The persistent objects will be written to the server when the object cache is flushed. The object is not locked or flushed by this function. It is an error to update a deleted object.
After an object is marked updated and flushed, this function must be called again to mark the object as updated if it has been dirtied after it is being flushed.
This function marks the specified transient object as updated. The transient objects will not be written to the server. It is an error to update a deleted object.
This function is an no-op for values.
For more information about the use of this function, see "Marking Objects and Flushing Changes".