|Oracle Call Interface Programmer's Guide
Release 2 (9.2)
Part Number A96584-01
More OCI Relational Functions, 34 of 106
Tests whether a LOB/FILE is open.
The service context handle.
An error handle which can be passed to
OCIErrorGet() for diagnostic information in the event of an error.
Pointer to the LOB locator being examined. The locator can refer to an internal or external LOB.
TRUE if the internal LOB is open or if the
BFILE was opened using the input locator. Returns
FALSE if it was not.
Checks to see if the internal LOB is open or if the
BFILE was already opened using the input locator.
If the input
BFILE locator was never passed to
BFILE is considered not to be opened by this
BFILE locator. However, a different
BFILE locator may have opened the
BFILE. More than one open can be performed on the same
BFILE using different locators. In other words, openness is associated with a specific locator for
Openness is associated with the LOB, not with the locator. If
locator1 opened the LOB then
locator2 also sees the LOB as open.
For internal LOBs, this call requires a server round- trip because it checks the state on the server to see if the LOB is indeed open. For external LOBs (
BFILEs), this call also requires a round- trip because the actual operating system file on the server side must be checked to see if it is actually open.