Share via


IMultipleResults

IMultipleResults is used to retrieve multiple results (row counts, rowset objects, or row objects) created by a command. For more information, see Multiple Results.

When to Implement

IMultipleResults is a mandatory interface on multiple results objects. Providers specify whether they support multiple results objects and what restrictions they have on these objects through the DBPROP_MULTIPLERESULTS property in the Data Source Information property group.

When to Call

To create a multiple results object, a consumer creates a command, sets the command text, and calls ICommand::Execute with riid set to IID_IMultipleResults. The command text generally specifies multiple results, although this is not required. To retrieve each result in succession, the consumer repeatedly calls IMultipleResults::GetResult.

Method

Description

GetResult

Returns the next in a series of multiple results from the provider.

This topic is a part of: