Previous | Table of Contents | Next |
void add_item ( // PIDL
in Identifier item_name, // name of item
in TypeCode item_type, // item datatype
in OpaqueValue value, // item value
in long value_len, // length of item value
in Flags item_flags // item flags );
This operation adds a new item to the indicated list. The item is added after the previously added item.
In addition to the argument modes defined in Section 7.1.1, “Common Data
Structures,? on page 7-2,
item_flags may also take the following flag values: IN_COPY_VALUE, DEPENDENT_LIST. The argument passing flags defined in
Section 7.1.1, “Common Data Structures,? on page 7-2 may be used here to indicate
the intended parameter passing mode of an argument.
If the IN_COPY_VALUE flag is set, a copy of the argument value is made and used instead.
If a list structure is added as an item (e.g., a “sublist?), the DEPENDENT_LIST flag may be specified to indicate that the
sublist should be freed when the parent list is freed.