|Oracle Call Interface Programmer's Guide
Release 2 (9.2)
Part Number A96584-01
OCI Navigational and Type Functions, 32 of 36
Unpins an object.
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 an object, which must already be pinned.
There is a pin count associated with each object which is incremented whenever an object is pinned. When the pin count of the object is zero, the object is said to be completely unpinned. An unpinned object can be freed implicitly by the OCI at any time without error.
This function unpins an object. An object is completely unpinned when any of the following is true:
OCIObjectPinCountReset()is called on the object.
When an object is completely unpinned, it can be freed implicitly by the OCI at any time without error.
The following rules apply for unpinning different types of objects:
When a persistent object is completely unpinned, it becomes a candidate for aging. The memory of an object is freed when it is aged out. Aging is used to maximize the utilization of memory. An dirty object cannot be aged out unless it is flushed.
The pin count of the object is decremented. A transient can be freed only at the end of its allocation duration or when it is explicitly deleted by calling
This function returns an error for values.
This section describes the OCI type information accessor functions.
Get an array of TDOs given an array of object names
Get an array of TDOs given an array of object references
Get a TDO given an object name
Get a TDO given an object reference