CLC_ErrorCode Controller_SendTextValue	(	CPHOBJECT const	hController,
		CPCHAR8 const *const	utf8Value
	)

Send a text value using the assigned message (only for controllers assigned to text parameter)

Parameters

[in]	hController	Controller handle
[in]	utf8Value	the text value

Remarks

If some destination is not yet validated, the method returns ERR_SentToNotYetValidatedDestination. The message delivery is not guaranteed for those destinations.

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.