Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awSet | awSetStructFieldFromEvent
 
awSetStructFieldFromEvent
BrokerError awSetStructFieldFromEvent(
BrokerEvent event,
char *field_name,
BrokerEvent value);
event
The event whose structure field is to be set.
field_name
Name of the event field structure whose values are being set. May be set to NULL if the top level of the event is to be set.
value
The new value for field_name.
Sets the field specified by field_name, of type struct, from the specified value. The parameter value is an event that contains the structure-field values. Any envelope fields contained in value will be ignored.
See Specifying Field Names for complete information on specifying field_name.
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.
AW_ERROR_INVALID_EVENT
The event is invalid.
AW_ERROR_INVALID_FIELD_NAME
The field_name is invalid.
See also: