Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_save_set_destroy() function destroys the specified save set and frees its resources.

mi_integer mi_save_set_destroy(save_set)

MI_SAVE_SET *save_set;

save_set

is a pointer to the save set to free.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
Yes	Yes

The mi_save_set_destroy() function frees resources for the save set that the save_set save-set structure references. This function is the destructor function for a save set. This save set must have been previously created with mi_save_set_create(). It is an error to attempt to access rows in a save set that was destroyed.

Important: Informix recommends that you explicitly deallocate save sets with mi_save_set_destroy() once you no longer need them. Otherwise, these save sets remain until the associated session ends.

Return Values

MI_OK	indicates that the function was successful.
MI_ERROR	indicates that the function was not successful.

See the description of the mi_save_set_create() function.