ATMI COBOL Function Reference
TPKEYCLOSE()
- close a previously opened key handle
01
TPKEYDEF-REC
.
COPY TPKEYDEF.
01TPSTATUS-REC
.
COPY TPSTATUS.
CALL "TPKEYCLOSE" USINGTPKEYDEF-REC
TPSTATUS-REC
.
TPKEYCLOSE()
releases a previously opened key handle and all resources associated with it. Any sensitive information, such as the principal's private key, is erased from memory.
The calling process must supply KEY-HANDLE
in TPKEYDEF-REC
. KEY-HANDLE
is a key identifier returned by a previous call to TPKEYOPEN()
.
Upon successful completion, TPKEYCLOSE()
sets TP-STATUS
in TPSTATUS-REC
to [TPOK
].
Upon failure, TPKEYCLOSE()
sets TP-STATUS
in TPSTATUS-REC
to one of the following values.