Registrations are now open. Join us today!
There is still a lot of work to do on the wiki yet! More information about editing can be found here.
Already have an account?

Microsoft KB Archive/184968

From BetaArchive Wiki
Knowledge Base

Adovcsp.exe Demonstrates Using Stored Procedures with ADO

Article ID: 184968

Article Last Modified on 8/9/2004


  • Microsoft SQL Server 6.5 Standard Edition
  • Microsoft SQL Server 7.0 Standard Edition
  • Microsoft ActiveX Data Objects 2.7
  • Microsoft ActiveX Data Objects 1.5
  • Microsoft ActiveX Data Objects 2.0
  • Microsoft ActiveX Data Objects 2.1
  • Microsoft ActiveX Data Objects 2.5
  • Microsoft ActiveX Data Objects 2.6
  • Microsoft Visual C++ 6.0 Enterprise Edition
  • Microsoft Visual C++ 6.0 Professional Edition
  • Microsoft Visual C++ 6.0 Standard Edition

This article was previously published under Q184968


Adovcsp.exe is a sample program that demonstrates opening keyset and forwardOnly cursors using ActiveX Data Objects (ADO) Recordsets by executing stored procedures on Microsoft SQL Server. It also shows how to open a disconnected record set. The sample uses the Visual C++ #import feature and demonstrates ADO Recordset GetState(), Parameters GetName() and GetValue(), and many other Recordset, Command and Connection methods.


The following file is available for download from the Microsoft Download Center:

Release Date: September 17, 2003

For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

The application assumes that you have a Microsoft SQL Server installed with the sample Pubs database. If this is not the case, change the following code in the openConn function:

spCON->ConnectionString = L"Provider=SQLOLEDB.1;Integrated Security=SSPI;Initial Catalog=pubs;Data Source=serverName;";

Replace Data Source=serverName with the name of your server and specify the name of your database. The sample creates two stored procedures and a table, and then drops them when the application exits.

The OpenRd method takes an input parameter (GradYear) and passes it to the stored procedure sp_AdoTestInOut. sp_AdoTestInOut returns all the records with GradYear >= to the parameter passed. It returns an output parameter, the number of records returned and also returns a parameter (the max GradYear). The student table created is based on the Student table of the Student Enrollment database that ships with Visual C++.

In this sample, the text boxes to show the Output parameter and Return code are only used when running the stored procedure by clicking the OpenRead button. Please see the source code for more details.

The Supports button obtains the schema information from the database using the technique and code described in the following Microsoft Knowledge Base article:

182831 HOWTO: Using the ADO OpenSchema Method from Visual C++

The Open DisCon button opens a disconnected recordset. This code is taken from the following Microsoft Knowledge Base article:

184397 HOWTO: Getting ADO Disconnected Recordsets in VBA/C++/Java


For additional information, click the following article numbers to view the articles in the Microsoft Knowledge Base:

182389 FILE: Adovcbm.exe ADO 1.5 with #import and Getrows/Bookmarks

181733 FILE: Adovcbtd.exe #import Using UpdateBatch and CancelBatch

220152 FILE: Sample: ADOVC1 Simple ADO/VC++ Application

200122 SAMPLE: ATL2ADO returns disconnected recordset from COM to VB

229088 SAMPLE: Vcspnp.exe Demonstrates Passing SQL NULL Parameters and Reading NULL Values with ADO

Additional query words: ADOVCSP kbdse

Keywords: kbinfo kbdownload kbdatabase kbfile KB184968