clear_serialized_item — Delete a serialized item.
clear_serialized_item( : : SerializedItemHandle : )
clear_serialized_item deletes a serialized item, which is
passed by the handle
fwrite_serialized_item for an introduction of the
basics of serialization). If a serialized item is created only
by a data pointer, it will not be deleted. Such a data pointer, that
points to the beginning of serialized item can be created
by the operator
get_serialized_item_ptr. After calling
clear_serialized_item, the handle of the serialized item
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
SerializedItemHandle(input_control, state is modified) serialized_item(-array)
Handle of the serialized item.
If the parameters are valid, the operator
clear_serialized_item returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.