CHAILink SDK  Version 1.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode LocalDevice_SetCustomName ( CPHOBJECT const  hLocalDevice,
CPCHAR8 const *const  utf8CustomName 
)

Set the Custom name.

If not empty, the custom name override the default name.

Parameters
[in]hLocalDeviceHandle to the local device.
[in]utf8CustomNameThe new custom name, or NULL to remove custom name.
Returns
Standard CHAILink Client return code. See CLC_ErrorCode enumeration.
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.