System i: Programming Secure Sockets APIs - IBM

Return Value
gsk_attribute_get_numeric_value() returns an integer. Possible values are:
[GSK_OK]
gsk_attribute_get_numeric_value() was successful.
[GSK_ATTRIBUTE_INVALID_ID]
The specified numID was not valid.
[GSK_INVALID_HANDLE]
The handle specified was not valid.
[GSK_OS400_ERROR_INVALID_POINTER]
The numValue pointer is not valid.
[GSK_ERROR_UNSUPPORTED]
The numID is currently not supported.
[GSK_ERROR_IO]
An error occurred in SSL processing, check the errno value.
Error Conditions
When the gsk_attribute_get_numeric_value() API fails with return code [GSK_ERROR_IO], errno can be
set to:
[EINTR]
Interrupted function call.
[EDEADLK]
Resource deadlock avoided.
[ETERM]
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.
Usage Notes
1. The following GSK_NUM_ID values may be retrieved from the SSL environment after
gsk_environment_open():
v GSK_V2_SESSION_TIMEOUT
v GSK_V3_SESSION_TIMEOUT
v GSK_HANDSHAKE_TIMEOUT
v GSK_OS400_READ_TIMEOUT
2. The following GSK_NUM_ID value may be retrieved from the SSL environment after
gsk_environment_init().
v GSK_CERTIFICATE_VALIDATION_CODE - Will return the certificate validation return code for
the local certificate.
3. The following GSK_NUM_ID value may be retrieved from each individual secure session after
gsk_secure_soc_init().
v GSK_CERTIFICATE_VALIDATION_CODE - Will return the certificate validation return code for
the peer’s certificate.
4. The following GSK_NUM_ID values may be retrieved from each individual secure session after
gsk_secure_soc_open().
Secure Sockets APIs 15