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.
Parameters<br />
int sslreturnvalue (Input)<br />
The Return Value received from a SSL API.<br />
char* string (Input)<br />
The string to be printed prior to the message associated with the sslreturnvalue. If no preceding<br />
message is desired, NULL must be entered.<br />
Authorities<br />
No authorization is required.<br />
Return Value<br />
There is no return value.<br />
Error Conditions<br />
This API calls the Retrieve SSL Runtime Error Message (SSL_Strerror) API in order to perform its task. It<br />
inherits all error conditions from this function. If the sslreturnvalue is unrecognized or if unable to<br />
retrieve the message corresponding to sslreturnvalue, then an Unknown error message will be printed<br />
following the string. Also, the message associated with the value found in the thread’s errno is printed.<br />
Note: the value of errno may be updated by SSL_Perror() in some error conditions.<br />
Error Messages<br />
See Error Conditions.<br />
Related Information<br />
v “SSL_Strerror()—Retrieve SSL Runtime Error Message” on page 95—Retrieve SSL Runtime Error<br />
Message<br />
v “SSL_Create()—Enable SSL Support for the Specified Socket Descriptor” on page 69—Enable SSL<br />
Support for the Specified Socket Descriptor<br />
v “SSL_Destroy()—End SSL Support for the Specified SSL Session” on page 71—End SSL Support for the<br />
Specified SSL Session<br />
v “SSL_Handshake()—Initiate the SSL Handshake Protocol” on page 74—Initiate the SSL Handshake<br />
Protocol<br />
v “SSL_Init()—Initialize the Current Job for SSL” on page 80—Initialize the Current Job for SSL<br />
v “SSL_Init_Application()—Initialize the Current Job for SSL Processing Based on the Application<br />
Identifier” on page 84—Initialize the Current Job for SSL Processing Based on the Application Identifier<br />
v “SSL_Read()—Receive Data from an SSL-Enabled Socket Descriptor” on page 91—Receive Data from<br />
an SSL-Enabled Socket Descriptor<br />
v “SSL_Write()—Write Data to an SSL-Enabled Socket Descriptor” on page 97—Write Data to an<br />
SSL-Enabled Socket Descriptor<br />
Example<br />
The following example shows how SSL_Perror() is used.<br />
Note: By using the code examples, you agree to the terms of the “Code license and disclaimer<br />
information” on page 111.<br />
#include <br />
#include <br />
#include <br />
#include <br />
#include <br />
90 <strong>System</strong> i: <strong>Programming</strong> <strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong>