|Oracle Call Interface Programmer's Guide
Part Number A89857-01
More OCI Relational Functions, 10 of 97
Create a temporary LOB
sword OCILobCreateTemporary(OCISvcCtx *svchp, OCIError *errhp, OCILobLocator *locp, ub2 csid, ub1 csfrm, ub1 lobtype, boolean cache, OCIDuration duration);
The OCI service context handle.
An error handle you can pass to
OCIErrorGet() for diagnostic information in the event of an error.
A locator which points to the temporary LOB. You must allocate the locator using
OCIDescriptorAlloc() before passing it to this function. It does not matter whether or not this locator already points to a LOB, it will get overwritten either way.
The LOB character set ID. For Oracle8i or later, pass as OCI_DEFAULT.
The LOB character set form of the buffer data. For Oracle8i or later, pass as OCI_DEFAULT.
The type of LOB to create. Valid values include:
TRUE if the temporary LOB should be read into the cache;
FALSE, if it should not. The default is
FALSE for NOCACHE functionality.
The duration of the temporary LOB. The following are valid values:
This function creates a temporary LOB and its corresponding index in the user's temporary tablespace.
When this function is complete, the
locp parameter points to an empty temporary LOB whose length is zero.
The lifetime of the temporary LOB is determined by the
duration parameter. At the end of its duration the temporary LOB is freed. An application can free a temporary LOB sooner with the
If the LOB is a
csfrm parameters are ignored.
For more information about temporary LOBs and their durations, refer to "Temporary LOB Support".