Gets a pointer to the thread-specific memory specified by CBL_TSTORE_CREATE.
Syntax:
call "CBL_TSTORE_GET" using by value tstore-handle
tstore-ptr
Parameters:
| |
Using call prototype (see
Key)
|
Picture
|
|
tstore-handle
|
cblt-pointer
|
usage pointer
|
|
tstore-ptr
|
cblt-pointer
|
usage pointer
|
On Entry:
-
tstore-handle
- A non-null handle. This is the handle returned by CBL_TSTORE_CREATE.
On Exit:
-
tstore-ptr
- A pointer to a memory block of the size specified by CBL_TSTORE_CREATE. This pointer is unique to this thread.
-
return-code
- Indicates success or otherwise of the routine:
| 0
|
Success
|
| 1000
|
Could not get the memory block requested
|
| 1001
|
Bad handle
|
| 1002
|
Closed handle
|
Comments:
Returns a pointer to a block of memory of the size specified by CBL_TSTORE_CREATE. This pointer is unique for each calling thread. A block of memory containing all zeroes indicates that CBL_TSTORE_GET has been run for the first time.
A value is returned in RETURN-CODE, indicating success or otherwise of the routine: