awGetUCStringFieldAsA

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

event	The event from which the string is to be retrieved.
field_name	The name of the unicode string field to be retrieved.
value	The ANSI string that was retrieved. This parameter is used for output.

Obtains an ANSI string field with the specified unicode string field_name from the event. The string returned in value will be in ANSI format, which encodes 16-bit Unicode characters using an escape notation, such as \u1234.

The caller is not responsible for freeing the return value.

Possible BrokerError major codes	Meaning
AW_ERROR_FIELD_NOT_FOUND	The field_name does not exist in the event type or an attempt was made to obtain the value of an envelope field that has not been set.
AW_ERROR_FIELD_TYPE_MISMATCH	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 parameter is NULL.