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.
8. If GSK_OS400_APPLICATION_ID is set, the GSK_KEYRING_FILE, the GSK_KEYRING_LABEL,<br />
and the GSK_KEYRING_PASSWORD values are ignored.<br />
Related Information<br />
v “gsk_attribute_get_buffer()—Get character information about a secure session or an SSL environment”<br />
on page 3<br />
v “gsk_attribute_set_enum()—Set enumerated information for a secure session or an SSL environment”<br />
on page 24<br />
v “gsk_attribute_set_numeric_value()—Set numeric information for a secure session or an SSL<br />
environment” on page 28<br />
v “gsk_environment_init()—Initialize an SSL environment” on page 32<br />
v “gsk_environment_open()—Get a handle for an SSL environment” on page 34<br />
v “gsk_secure_soc_init()—Negotiate a secure session” on page 38<br />
v “gsk_secure_soc_misc()—Perform miscellaneous functions for a secure session” on page 41<br />
v “gsk_secure_soc_open()—Get a handle for a secure session” on page 44<br />
v “gsk_strerror()—Retrieve GSKit runtime error message” on page 62<br />
API introduced: V5R1<br />
Top | UNIX-Type <strong>APIs</strong> | <strong>APIs</strong> by category<br />
gsk_attribute_set_callback()—Set callback pointers to routines in the<br />
user application<br />
Syntax<br />
#include <br />
int gsk_attribute_set_callback(gsk_handle my_gsk_handle,<br />
GSK_CALLBACK_ID callBackID,<br />
void *callBackAreaPtr);<br />
Service Program Name: QSYS/QSOSSLSR<br />
Default Public Authority: *USE<br />
Threadsafe: Yes<br />
The gsk_attribute_set_callback() function is used to set callback pointers to routines in the user<br />
application. These routines may be used for special purposes by the application.<br />
Parameters<br />
my_gsk_handle (Input)<br />
Indicates one of the following handles:<br />
v The handle for the secure session. (my_session_handle)<br />
v The handle for the SSL environment. (my_env_handle)<br />
callBackID (Input)<br />
Indicates one of the following operations:<br />
v GSK_ENVIRONMENT_CLOSE_CALLBACK (804) - This is the callback to have a user routine<br />
be called when the last secure session is closed that was created based on secure environment<br />
that already has been closed.<br />
20 <strong>System</strong> i: <strong>Programming</strong> <strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong>