This project is read-only.

Readme_Fetching Columns Using IRow::GetColumns (OLE DB)

11/05/2008 21:36:06

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 use the IRow interface to allow direct access to columns of a single row in the result set. 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 (OLE DB) in Books Online.


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


Before running this sample, make sure the following software is installed:
  • SQL Server or SQL Server Express including Database Engine. You can download SQL Server Express from the Microsoft Download Center.
  • The AdventureWorks database which is included with SQL Server, and is also available at the Microsoft SQL Server Developer Center.
  • The SQL Server Database Engine samples. These samples are included with SQL Server. You can download the latest version of the samples at the Microsoft SQL Server Developer Center.
  • .NET Framework SDK 2.0 or Microsoft Visual Studio 2005. You can obtain .NET Framework SDK free of charge. See Installing the .NET Framework Documentation.

Building the Sample

  • 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). By default, SQL Server Express installs to a named instance. To connect to a named instance, change the connection string from L"(local)" to L"(local)\\name" , where name is the 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
    '11/1/1999 11:52 AM',
    CONVERT(nchar(50), N'AbCdEfGhIjKlMnOpQrStUvWxYz'),
    REPLICATE(0x123456789, 500)
    GO * 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_B.sln file and build it.
    • If you are using MSBuild.exe, invoke MSBuild.exe at a command prompt, passing it the FetchColumns_B.sln file: * MSBuild FetchColumns_B.sln *

    Running the Sample

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

    See Also

    Data Access Samples
    Help and Information
    • Getting SQL Server 2008 Assistance* © 2008 Microsoft Corporation. All rights reserved.

Last edited Nov 6, 2008 at 10:49 PM by bonniefe, version 9


No comments yet.