awSetUCStringFieldAsA

BrokerError awSetUCStringFieldAsA(
BrokerEvent event,
char *field_name,
char *value);

event	The event whose field is to be set.
field_name	Name of the destination event field to set.
value	The source value for the field. The value's type varies from function to function.

Sets the specified event field using the value, which contains a string in ANSI format. ANSI format allows 16-bit Unicode characters to be represented using an escape notation, such as \u1234.

See Specifying Field Names for complete information on specifying field_name.

Note:
Attempting to set an event field with a type that does not match the event's definition will result in an error being returned.

Possible BrokerError major codes	Meaning
AW_ERROR_FIELD_NOT_FOUND	The event is associated with a Broker client and field_name does not exist in the event.
AW_ERROR_FIELD_TYPE_MISMATCH	The field's type does not match the type of value or the field_name incorrectly accesses a type, such as using a subscript on a non-sequence field.
AW_ERROR_INVALID_EVENT	The event is invalid.
AW_ERROR_INVALID_FIELD_NAME	The field_name is invalid.
AW_ERROR_NULL_PARAM	The field_name or value is NULL.