cwbCO_CanModifyDefaultUserMode

Purpose

Indicates whether the default user mode for the specified system object may be modified.

Syntax

 
UINT CWB_ENTRY cwbCO_CanModifyDefaultUserMode(
                             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 this mode 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 that is using the specified system object already has 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.