Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)

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

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.

1998-2001 Microsoft Corporation. All rights reserved.