awSetStructSeqFieldFromEvents

BrokerError awSetStructSeqFieldFromEvents(
BrokerEvent event,
char *field_name,
int src_offset,
int dest_offset,
int n,BrokerEvent *value);

event	The event whose field is to be set.
field_name	The name of the event field to be set.
src_offset	The number of elements to skip from the beginning of the source elements.
dest_offset	The number of elements to skip from the beginning of the destination sequence.
n	Number of source elements (structures) contained in value.
value	An array of events that represent structures.

Sets the destination structure sequence field field_name from the specified source value, which is expressed as an array of events. Each of the events in value should contain fields that correspond to the fields of a structure. Envelope fields on the value events are ignored.

Note:
This function may overwrite all or part of the destination structure sequence field.

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 or any event in the array value is invalid.
AW_ERROR_INVALID_FIELD_NAME	The field_name is invalid.
AW_ERROR_NULL_PARAM	The parameter field_name or value is NULL.
AW_ERROR_OUT_OF_RANGE	The src_offset is not within the range of the array value, the dest_offset is less than zero, or n is less than -1.