CHAILink SDK  Version 1.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode Parameter_RefreshCurrentTextParameterValue ( CPHOBJECT const  hParameter,
CPUINT16 const  wIndex,
CPCHAR8 const *const  utf8ValueText,
RefreshValueAttributes const  attributes 
)

Notify the connected Outputs & Controllers about a Text parameter change. This causes an immediate sending of the feedback to the remote watchers.

Remarks
In case of Learning in progress, the learning device is automatically notified about the parameter change if the attribute parameter contains the CPNS::Enums::RVA_ValidForLearning flag.
Parameters
[in]hParameterParameter handle. Must be a text.
[in]wIndexthe related parameter index, or 0 if the parameter is not indexed.
[in]utf8ValueTextValue string representation
[in]attributesAdditional attributes
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.