System i: Programming Secure Sockets APIs - IBM

gsk_secure_soc_close()—Close a secure session
Syntax
#include
int gsk_secure_soc_close(gsk_handle *my_session_handle);
Service Program Name: QSYS/QSOSSLSR
Default Public Authority: *USE
Threadsafe: Yes
The gsk_secure_soc_close() function is used to close a secure session and free all the associated resources
for that secure session.
Parameters
my_session_handle (Input)
A pointer to the handle for the secure session to be closed. This handle originated from a call to
gsk_secure_soc_open().
Authorities
No authorization is required.
Return Value
gsk_secure_soc_close() returns an integer. Possible values are:
[GSK_OK]
gsk_secure_soc_close() was successful.
[GSK_CLOSE_FAILED]
An error occurred during close processing.
[GSK_INVALID_HANDLE]
The handle specified was not valid.
[GSK_ERROR_IO]
An error occurred in SSL processing, check the errno value.
Error Conditions
When the gsk_secure_soc_close() API fails with return code [GSK_ERROR_IO], errno can be set to:
[EINTR]
[EDEADLK]
[ETERM]
Interrupted function call.
Resource deadlock avoided.
Operation terminated.
If an errno is returned that is not in this list, look in “Errno Values for UNIX-Type Functions” on page 103
for a description of the errno.
Secure Sockets APIs 37