OCIContextGenerateKey()

Purpose

This call will return a unique, 4-byte value each time it is called.

Syntax

sword OCIContextGenerateKey( dvoid    *hndl, 
                             OCIError *err, 
                             ub4      *key );

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.

Comments

This value is going to be unique for each session.

Returns

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

Cartridge Services -- Parameter Manager Interface

Table 19-4 Parameter Manager Interface Functions

Function/Page	Purpose
OCIExtractInit()	Initializes the parameter manager.
OCIExtractTerm()	Releases all dynamically allocated storage.
OCIExtractReset()	Re-initializes memory.
OCIExtractSetNumKeys()	Informs the parameter manager of the number of keys that will be registered.
OCIExtractSetKey()	Registers information about a key with the parameter manager.
OCIExtractFromFile()	The keys and their values in the given file are processed.
OCIExtractFromStr()	The keys and the their values in the given string are processed.
OCIExtractToInt()	Gets the integer value for the specified key.
OCIExtractToBool()	Gets the boolean value for the specified key.
OCIExtractToStr()	Gets the string value for the specified key.
OCIExtractToOCINum()	Gets the number value for the specified key.
OCIExtractToList()	Generates a list of parameters from the parameter structures that are stored in memory.
OCIExtractFromList()	Generates a list of values for the parameter denoted by index in the parameter list.

See Also: For more information about using these functions, see Oracle9i Data Cartridge Developer's Guide