System i: Programming Secure Sockets APIs - IBM

#include
#include
int gsk_secure_soc_startInit(gsk_handle my_session_handle,
int IOCompletionPort,
Qso_OverlappedIO_t * communicationsArea)
Service Program Name: QSYS/QSOSSLSR
Default Public Authority: *USE
Threadsafe: Yes
The gsk_secure_soc_startInit() function is used to initiate an asynchronous negotiation of a secure
session, using the attributes set for the SSL environment and the secure session. This API starts the SSL
handshake to the remote peer and upon successful completion of QsoWaitForIOCompletion() a secure
session is established.
Parameters
my_session_handle (Input)
The handle returned from gsk_secure_soc_open() that will be used to negotiate the secure
session.
int IOCompletionPort (Input)
The I/O completion port that should be posted when the operation completes.
Qso_OverlappedIO_t * communicationsArea (Input/Output)
A pointer to a structure that contains the following information:
descriptorHandle (Input) - The descriptor handle is application specific and is never used by the system.
This field is intended to make it easier for the application to keep track of information
regarding a given socket connection.
buffer Not used.
bufferLength Not used.
postFlag Not used.
postFlagResult Not used.
fillBuffer Not used.
returnValue (Output) - When the negotiate operation completes asynchronously, this field contains
indication of success or failure.
errnoValue (Output) - When the negotiate operation completes asynchronously and returnValue is
GSK_ERROR_IO, this field will contain an errno further defining the failure.
operationCompleted (Output) - If the operation is posted to the I/O completion port, this field is updated
to indicate that the operation was a GSKSECURESOCSTARTINIT.
secureDataTransferSize Not used.
bytesAvailable Not used.
operationWaitTime Not used.
postedDescriptor Not used - Must be set to zero.
operationId (Input) - An identifier to uniquely identify this operation or a group of operations. It
can be set with the return value from QsoGenerateOperationId() or with an
application-defined value.
This value is preserved but ignored by all APIs except QsoCancelOperation() and
QsoIsOperationPending().
reserved1 (Output) - Must be set to hexadecimal zeroes.
reserved2 (Input) - Must be set to hexadecimal zeroes.
Secure Sockets APIs 49