IMultipleResults

IMultipleResults is used to retrieve multiple results (rowsets or row counts) created by a command. For more information, see "Multiple Results" in Chapter 3.

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.