cwbCO_CanModifyUseSecureSockets

Purpose

Indicates whether the secure sockets use setting may be modified for this system object.

Syntax

 
UINT CWB_ENTRY cwbCO_CanModifyUseSecureSockets(
                             cwbCO_SysHandle         system,
                             cwb_Boolean            *canModify );

Parameters

cwbCO_SysHandle system - input

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

cwb_Boolean *canModify - output

Set to CWB_TRUE if the secure sockets use setting may be modified, otherwise set to CWB_FALSE.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_INVALID_API_HANDLE

Invalid system handle.

CWB_INVALID_POINTER

The canModify pointer is NULL.

Usage

This value may not be modified if policy settings prohibit its modification, or if a successful signon or connection using the specified system object has already occurred. In these cases, canModify will be set to CWB_FALSE. The results returned from this API are correct only at the time of the call. If policy settings are changed or a signon or connection is performed using this system object, the results of this API could become incorrect. This must be considered and managed, especially in a multi-threaded application.