[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 "Katmai". It will not work with any version of SQL Server earlier than SQL Server 2005.
Executes user-defined function, prints return code. This sample is not supported on IA64.
Scenario
For more information on this sample, see How to: Execute a User-Defined Function and Process Return Code (OLE DB) in Books Online.
Languages
This sample uses Transact-SQL and Visual C++.
Prerequisites
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 theMicrosoft 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 SDK.
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). To connect to a named instance, change the connection string from
L"(local)"
toL"(local)\\name"
, wherename
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 that you add the following user-defined function, which you can find in the sample's scripts directory:
In SQL Server Management Studio, load and execute the Scripts\setup.sql script or execute the following command in a Command Prompt window:USE AdventureWorks drop function fn_RectangleArea go CREATE FUNCTION fn_RectangleArea (@Width int, @Height int ) RETURNS int AS BEGIN RETURN ( @Width * @Height ) END GO
sqlcmd -E -I -i Scripts\setup.sql
-
If you are using Visual Studio, load the InitializeAndEstablishConnection_C.sln file and build it.
-
If you are using MSBuild.exe, invoke MSBuild.exe at a command prompt, passing it the InitializeAndEstablishConnection_C.sln file:
MSBuild InitializeAndEstablishConnection_C.sln
Running the Sample
-
From Visual Studio, invoke Start Without Debugging (CTRL+F5).
-
If you built with MSBuild.exe, invoke InitializeAndEstablishConnection_C.exe.