awGetStructSeqFieldAsEvents

BrokerError awGetStructSeqFieldAsEvents(
BrokerEvent event,
char *field_name,
int offset,
int max_n,
int *n,
BrokerEvent **value_array);

event	The event containing the sequence field to be obtained.
field_name	The name of an event field that is a sequence of structures.
offset	The number of elements (that is, structures) to skip from the beginning of the sequence.
max_n	The number of elements requested. If set to -1, all elements are requested.
n	The number of elements returned. This parameter is used for output.
value_array	An array of events, each of which represents a structure. This parameter is used for output.

Provides an array of events, each one representing a structure in the sequence contained in event. See awGetStructFieldAsEvent for information on representing a structure as an event. For information on how to use offset, max_n, and value_array; see awGet<type>SeqField.

If you get a structure sequence field whose value was not set by the event's publisher, a zero-length array will be returned.

Important:
Since the events returned in value_array are not associated with a Broker client, they will not type checked.

Possible BrokerError major codes	Meaning
AW_ERROR_FIELD_NOT_FOUND	The field_name does not exist in the event 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'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.
AW_ERROR_NULL_PARAM	The parameter field_name or value_array is NULL.
AW_ERROR_OUT_OF_RANGE	The offset is less than zero or greater than the sequence size, or max_n is less than zero.