cwbCO_CanModifyIPAddress

Purpose

Indicates whether IP Address that is used to connect may be modified for this system object.

Syntax

 
UINT CWB_ENTRY cwbCO_CanModifyIPAddress(
                             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 IP Address 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 by using the specified system object already has occurred. In these cases, canModify will be set to CWB_FALSE. This value may not be modified if the IP Address Lookup Mode is not CWBCO_IPADDR_LOOKUP_NEVER, and policy settings prohibit modification of the IP Address Lookup Mode. In that case, 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.