7.5.2 add_item

   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.