cwbCO_CanModifyDefaultUserMode

Use the cwbCO_CanModifyDefaultUserMode command.

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 is the IBM iidentification.
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.