CHAILink SDK  Version 1.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode RemoteDevice_GenericChange ( CPHOOKEDOBJECT const  hRemoteDevice,
CPCHAR8 const *const  utf8CustomName,
CPUINT32 const  dwDuplicateNumber,
DuplicateModes const  duplicateMode,
CPUINT32 const  dwGroups 
)

Apply generic changes.

Parameters
[in]hRemoteDeviceHandle to the remote device.
[in]utf8CustomNameCustom name, can be NULL to clear it and come back to default name
[in]duplicateModeDuplicate resolution mode
[in]dwDuplicateNumberPreferred duplicate number for DM_Auto mode (might change in case of conflict), or required number for DM_Fixed mode.
[in]dwGroupsGroup bit field: 31 LSB = one per group; MSB = super-group
Returns
Standard CHAILink Client return code. See CLC_ErrorCode enumeration.
Remarks
Changes are applied only if the related Enhanced Device Capability is set
Warning
This function can only be called in CopperLan context. This means in the pseudo task CPDoProcess(), in notification handlers or in asynchronous return handlers and not in SystemDoProcess() for instance.