22.10.2013 Views

System i: Programming Secure Sockets APIs - IBM

System i: Programming Secure Sockets APIs - IBM

System i: Programming Secure Sockets APIs - IBM

SHOW MORE
SHOW LESS

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>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!