OCIContextGetValue()

Purpose

This call is used to return the value that is stored in the context associated with the given key (by calling OCIContextSetValue()).

Syntax

sword OCIContextGetValue( dvoid      *hndl, 
                          OCIError   *err, 
                          ub1        *key, 
                          ub1        keylen, 
                          dvoid      **ctx_value );

Parameters

hndl (IN)

The OCI environment or user session handle.

err (IN)

The error handle.

key (IN)

Unique key value.

keylen (IN)

Length of the key. Maximum is 64 bits.

ctx_value (IN)

Pointer to the value stored in the context (null if no value was stored).

Comments

Forctx_value: a pointer to a preallocated pointer for the stored context to be returned is required.

Returns

• If operation succeeds, return OCI_SUCCESS.
• If operation fails, return OCI_ERROR.