System i: Programming Secure Sockets APIs - IBM
System i: Programming Secure Sockets APIs - IBM
System i: Programming Secure Sockets APIs - IBM
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
active secure sessions will continue to work and the environment close will effectively be<br />
delayed. The resources for the SSL environment will not be freed up until after the last secure<br />
session closes. No new secure sessions will be allowed to start using the closed SSL<br />
environment. enumValue must specify one of the following:<br />
– GSK_DELAYED_ENVIRONMENT_CLOSE (536) - Enable the environment close callback<br />
routine support.<br />
– GSK_NORMAL_ENVIRONMENT_CLOSE (537) - Field is ignored.<br />
enumValue (Input)<br />
An enumerated type appropiate to the enumID.<br />
Authorities<br />
No authorization is required.<br />
Return Value<br />
gsk_attribute_set_enum() returns an integer. Possible values are:<br />
[GSK_OK]<br />
gsk_attribute_set_enum() was successful.<br />
[GSK_ATTRIBUTE_INVALID_ENUMERATION]<br />
The enumeration specified for the enumValue was not valid.<br />
[GSK_ATTRIBUTE_INVALID_ID]<br />
The enumID specified was not valid.<br />
[GSK_CONFLICTING_VALIDATION_SETTING]<br />
The value for GSK_SERVER_AUTH_TYPE or GSK_CLIENT_AUTH_TYPE conflicts with the<br />
setting for the validationCallBack.validateRequired field for GSK_CERT_VALIDATION_CALLBACK<br />
set by gsk_attribute_set_callback().<br />
[GSK_INVALID_STATE]<br />
One of the following occurred:<br />
v The enumID cannot be set after a gsk_environment_init() has been issued.<br />
v The enumID cannot be set after a gsk_secure_soc_init() has been issued.<br />
[GSK_INVALID_HANDLE]<br />
The handle specified was not valid.<br />
[GSK_ERROR_UNSUPPORTED]<br />
The enumID is currently not supported.<br />
[GSK_ERROR_IO]<br />
An error occurred in SSL processing, check the errno value.<br />
Error Conditions<br />
When the gsk_attribute_set_enum() API fails with return code [GSK_ERROR_IO], errno can be set to:<br />
[EINTR]<br />
Interrupted function call.<br />
[EDEADLK]<br />
Resource deadlock avoided.<br />
[ETERM]<br />
Operation terminated.<br />
If an errno is returned that is not in this list, look in “Errno Values for UNIX-Type Functions” on page 103<br />
for a description of the errno.<br />
26 <strong>System</strong> i: <strong>Programming</strong> <strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong>