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.
Authorities<br />
No authorization is required.<br />
Return Values<br />
gsk_secure_soc_startSend() returns an integer. Possible values are:<br />
v GSK_OK- The function has completed synchronously. The Qso_OverlappedIO_t communications<br />
structure has been updated but nothing has nor will be posted to the I/O completion port for this<br />
operation. Inspect field secureDataTransferSize in the Qso_OverlappedIO_t communications structure<br />
to determine the number of bytes sent.<br />
v GSK_AS400_ASYNCHRONOUS_SEND - The function has been started. When the function completes<br />
(or times out if operationWaitTime was specified), the Qso_OverlappedIO_t communications structure<br />
will be updated with the results and the I/O completion port will be posted.<br />
v If the function fails, possible values are:<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 />
The bufferLength field located in the Qso_OverLappedIO_t communications area is less than 1.<br />
[GSK_ERROR_SOCKET_CLOSED]<br />
A close() was done on the socket descriptor for this secure session.<br />
[GSK_ AS400_ERROR_INVALID_POINTER]<br />
The buffer pointer located in Qso_OverlappedIO_t communications area is not valid.<br />
[GSK_INTERNAL_ERROR]<br />
An unexpected error occurred during SSL processing.<br />
[GSK_AS400_ERROR_INVALID_ OVERLAPPEDIO_T]<br />
The Qso_OverLappedIO_t specified was not valid.<br />
[GSK_AS400_ERROR_INVALID_ IOCOMPLETIONPORT]<br />
The I/O completion port specified was not valid.<br />
[GSK_AS400_ERROR_BAD_SOCKET_DESCRIPTOR]<br />
The socket descriptor specified within the gsk_handle was not valid.<br />
GSK_ERROR_IO]<br />
An error occured in SSL processing; check the errno value.<br />
Error Conditions<br />
When gsk_secure_soc_startSend() API fails with return code [GSK_ERROR_IO], errno can be set to:<br />
[EINVAL]<br />
The field operationWaitTime.tv_sec was negative or operationWaitTime.tv_usec was not zero or<br />
postedDescriptor was not zero.<br />
58 <strong>System</strong> i: <strong>Programming</strong> <strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong>