copyResultSet

This function creates a copy of a result set. The copy is owned by the calling application.

Detail

An application might need to make several C API calls on a result set. This is useful because some C API calls overwrite an existing result set with new results. A local copy of the result set is created using this function.

The copyResultSet function takes two result set tokens. The source token refers to the original result set. The target token refers to a copy of the result set. The copy is created by this function. The calling application owns the target result set.

There is no structural difference between the original and the target result sets. Result set functions work with C API-owned result sets or application-owned result sets.

When the application finishes using the copied result set, free the storage using the freeResultSet function.