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: