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.