|Oracle Call Interface Programmer's Guide
Release 2 (9.2)
Part Number A96584-01
More OCI Relational Functions, 81 of 106
Creates a key.
sword OCIThreadKeyInit (dvoid *hndl, OCIError *err, OCIThreadKey **key, OCIThreadKeyDestFunc destFn );
The OCI environment or user session handle.
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
The OCIThreadKey in which to create the new key.
The destructor for the key.
NULL is permitted.
Each call to this routine allocate and generates a new key that is distinct from all other keys. After this function executes successfully, a pointer to an allocated and initialized key is return. That key can be used with
OCIThreadKeySet(). The initial value of the key will be
NULL for all threads.
It is illegal for this function to be called more than once with the same value for the
destFn parameter is not
NULL, the routine pointed to by
destFn will be called whenever a thread that has a non-
NULL value for the key terminates. The routine will be called with one parameter. The parameter will be the keys value for the thread at the time at which the thread terminated. If the key does not need a destructor function, pass