Readme_Fetching Columns Using IRow::GetColumns/IRow::Open and ISequentialStream (OLE DB)

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

This sample works only with SQL Server 2005 and SQL Server 2008. It will not work with any version of SQL Server earlier than SQL Server 2005.

This sample shows how to fetch a single row using IRow. This sample is not supported on IA64.

SQL Server samples and sample databases must be downloaded and installed before you can view or work with them. For more information, see Considerations for Installing SQL Server Samples and Sample Databases.

For more information on this sample, see How to: Fetch Columns Using IRow::GetColumns (or IRow::Open) and ISequentialStream in Books Online.

This sample uses Transact-SQL and Visual C++.

Before running this sample, make sure the following software is installed:

  • This sample connects to your computer's default SQL Server instance (on some Windows operating systems, you will need to change (localhost) or (local) to the name of your SQL Server instance). To connect to a named instance, change the connection string from L"(local)" to L"(local)\\name", where name is the named instance. By default, SQL Server Express installs to a named instance.
  • Make sure your INCLUDE environment variable includes the directory that contains sqlncli.h.
  • The sample requires you to execute the following Transact-SQL statements, which you can find in the sample's scripts directory:
    USE AdventureWorks
    IF EXISTS (SELECT name FROM sysobjects WHERE name = 'MyTable')
         DROP TABLE MyTable
         col1  int,
         col2  varchar(50),
         col3  char(50),
         col4  datetime,
         col5  float,
         col6  money,
         col7  sql_variant,
         col8  binary(50),
         col9  text,
         col10 image
    /* Enter data. */
         '11/1/1999 11:52 AM',
         CONVERT(nchar(50), N'AbCdEfGhIjKlMnOpQrStUvWxYz'),
         REPLICATE('AAAAABBBBB', 500),
         REPLICATE(0x123456789, 500)
    In SQL Server Management Studio, load and execute the Scripts\setup.sql script or execute the following command in a Command Prompt window:
    sqlcmd -E -I -i Scripts\setup.sql
  • If you are using Visual Studio, load the FetchColumns_A.sln file and build it.
  • If you are using MSBuild.exe, invoke MSBuild.exe at a command prompt, passing it the FetchColumns_A.sln file:
    MSBuild FetchColumns_A.sln

  • From Visual Studio, invoke Start Without Debugging (CTRL+F5).
  • If you built with MSBuild.exe, invoke FetchColumns_A.exe.

Community Additions