System i: Programming Secure Sockets APIs - IBM
System i: Programming Secure Sockets APIs - IBM
System i: Programming Secure Sockets APIs - IBM
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
v “gsk_secure_soc_misc()—Perform miscellaneous functions for a secure session” on page 41—Perform<br />
miscellaneous functions for a secure session<br />
v “gsk_strerror()—Retrieve GSKit runtime error message” on page 62—Retrieve GSK runtime error<br />
message<br />
API introduced: V5R1<br />
Top | UNIX-Type <strong>APIs</strong> | <strong>APIs</strong> by category<br />
gsk_secure_soc_read()—Receive data on a secure session<br />
Syntax<br />
#include <br />
int gsk_secure_soc_read(gsk_handle my_session_handle,<br />
char *readBuffer,<br />
int readBufSize,<br />
int *amtRead);<br />
Service Program Name: QSYS/QSOSSLSR<br />
Default Public Authority: *USE<br />
Threadsafe: Yes<br />
The gsk_secure_soc_read() function is used by a program to receive data from a secure session.<br />
Parameters<br />
my_session_handle (Input)<br />
The handle, returned from gsk_secure_soc_open() and used on the gsk_secure_soc_init() API call<br />
that initialized the secure session over which data is to be read.<br />
readBuffer (Output)<br />
The pointer to the user-supplied buffer in which the data is to be stored.<br />
readBufSize (Input)<br />
The number of bytes to be read.<br />
amtRead (Output)<br />
The number of bytes that were read as a result of this API call.<br />
Authorities<br />
No authorization is required.<br />
Return Value<br />
gsk_secure_soc_read() returns an integer. Possible values are:<br />
[GSK_OK]<br />
gsk_secure_soc_read() was successful.<br />
[GSK_INVALID_HANDLE]<br />
The handle specified was not valid.<br />
[GSK_INVALID_STATE]<br />
The handle is not in the correct state for this operation.<br />
[GSK_INVALID_BUFFER_SIZE]<br />
46 <strong>System</strong> i: <strong>Programming</strong> <strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong>