OCIExtProcGetEnv()

Purpose

Gets the OCI environment, service context, and error handles.

Syntax

sword OCIExtProcGetEnv ( OCIExtProcContext    *with_context, 
                         OCIEnv                envh, 
                         OCISvcCtx             svch, 
                         OCIError              errh );
Parameters

with_context (IN)

The with_context pointer that is passed to the C External Procedure. See "With_Context Type".

envh (OUT)

The OCI Environment handle.

svch (OUT)

The OCI Service handle.

errh (OUT)

The OCI Error handle.

Comments

The primary purpose of this function is to allow OCI callbacks to use the database in the same transaction. The OCI handles obtained by this function should be used in OCI callbacks to the database. If these handles are obtained through standard OCI calls, then these handles use a new connection to the database and cannot be used for callbacks in the same transaction. In one external procedure you can use either callbacks or a new connection, but not both.

Returns

This function returns OCI_SUCCESS if the call was successful; otherwise, it returns OCI_ERROR.

Related Functions

OCIEnvCreate(), OCIAttrGet(), OCIHandleAlloc()

Cartridge Services -- Memory Services

Table 19-2 Memory Services Functions

Function/Page	Purpose
OCIDurationBegin()	Starts a user duration.
OCIDurationEnd()	Terminates a user duration.
OCIMemoryAlloc()	Allocates memory of a given size from a given duration.
OCIMemoryResize()	Resizes a memory chunk.
OCIMemoryFree()	Frees a memory chunk.