cwbCO_IsSecureSockets

Purpose

This function gets (for the specified system object) whether Secure Sockets is being used (if connected), or would be attempted (if not currently connected) for a connection.

Syntax

 
UINT CWB_ENTRY cwbCO_IsSecureSockets(
                             cwbCO_SysHandle    system,
                             cwb_Boolean       *inUse );

Parameters

cwbCO_SysHandle system - input

Handle that previously was returned from cwbCO_CreateSystem or cwbCO_CreateSystemLike. It identifies the iSeries™ system.

cwb_Boolean * inUse - output

Returns whether iSeries Access is using, or will try to use, secure sockets for communication:

CWB_TRUE: IS in use or would be if connections active.
CWB_FALSE: NOT in use, would not try to use it.

Return Codes

The following list shows common return values:

CWB_OK: Successful completion.
CWB_INVALID_API_HANDLE: Invalid system handle.
CWB_INVALID_POINTER: The inUse pointer is NULL.

Usage

This flag is an indication of what iSeries Access for Windows^® attempts will TRY to do for any future communications. If CWB_TRUE is returned, then any attempt to communicate to the iSeries system that cannot be performed using secure sockets will fail.

Start of change Although with limitations, iSeries Access for Windows enforces Federal Information Processing Standards (FIPS) compliance when SSL is used, this API does not return an indication of whether FIPS compliance is on or off. The only way to verify that FIPS-compliance is on or off is to visually inspect the FIPS compliance checkbox in iSeries Access for Windows Properties. For more information about FIPS and its use, see the User's Guide installed with iSeries Access for Windows. End of change