OCIThreadTerm()

Purpose

Releases the OCIThread context.

Syntax

sword OCIThreadTerm ( dvoid     *hndl, 
                      OCIError  *err );

Parameters

hndl (IN/OUT)

The OCI environment or user session handle.

err (IN/OUT)

The OCI error handle. If there is an error and OCI_ERROR is returned, the error is recorded in err and diagnostic information can be obtained by calling OCIErrorGet().

Comments

This function should be called exactly once for each call made to OCIThreadInit().

It is safe to make concurrent calls to OCIThreadTerm(). OCIThreadTerm() will not do anything until it has been called as many times as OCIThreadInit() has been called. When that happens, it terminates the OCIThread layer and frees the memory allocated for the context. Once this happens, the context should not be re-used. It will be necessary to obtain a new one by calling OCIThreadInit().

Related Functions

OCIThreadInit()

Transaction Functions

This section describes the transaction functions.

Table 16-6 Transaction Functions  

Function	Purpose
OCITransCommit()	Commit a transaction on a service context
OCITransDetach()	Detach a transaction from a service context
OCITransForget()	Forget a prepared global transaction
OCITransMultiPrepare()	Prepare a transaction with multiple branches in a single cell
OCITransPrepare()	Prepare a global transaction for commit
OCITransRollback()	Roll back a transaction
OCITransStart()	Start a transaction on a service context