Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awSet | awSetStructSeqFieldFromEvents
 
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.
See also: