|Oracle Call Interface Programmer's Guide
Release 2 (9.2)
Part Number A96584-01
OCI Relational Functions, 5 of 38
Allocates and initializes an OCI environment handle.
A pointer to a handle to the environment.
Specifies initialization of an environment mode. Valid modes are:
In OCI_DEFAULT mode, the OCI library always mutexes handles. In OCI_NO_MUTEX modes, there is no mutexing in this environment.
In OCI_NO_MUTEX mode, all OCI calls done on the environment handle, or on handles derived from the environment handle, must be serialized. This can be done by either doing your own mutexing or by having only one thread operating on the environment handle.
The OCI_ENV_NO_UCB mode is used to suppress the calling of the dynamic callback routine
OCIEnvCallback() at environment initialization time. The default behavior is to allow such a call to be made.
Specifies the amount of user memory to be allocated for the duration of the environment.
Returns a pointer to the user memory of size
xtramemsz allocated by the call for the user for the duration of the environment.
This call allocates and initializes an OCI environment handle. No changes are done to an already initialized handle. If OCI_ERROR or OCI_SUCCESS_WITH_INFO is returned, the environment handle can be used to obtain ORACLE specific errors and diagnostics.
This call is processed locally, without a server round-trip.
The environment handle can be freed using
For more information about the