分配句柄并连接到 SQL Server （ODBC）

2017-03-06

分配句柄并连接到 SQL Server

包括 ODBC 头文件 Sql.h、Sqlext.h、Sqltypes.h。
包括特定于 SQL Server 驱动程序的头文件 Odbcss.h。
使用 HandleType SQL_HANDLE_ENV 调用 SQLAllocHandle 以初始化 ODBC 并分配环境句柄。
调用设置为SQL_ATTR_ODBC_VERSION的 SQLSetEnvAttrAttribute，并ValuePtr设置为SQL_OV_ODBC3以指示应用程序将使用 ODBC 3.x 格式的函数调用。
（可选）调用 SQLSetEnvAttr 以设置其他环境选项，或调用 SQLGetEnvAttr 获取环境选项。
使用 HandleType SQL_HANDLE_DBC 调用 SQLAllocHandle 以分配连接句柄。
（可选）调用 SQLSetConnectAttr 以设置连接选项，或调用 SQLGetConnectAttr 获取连接选项。
调用 SQLConnect 以使用现有数据源连接到 SQL Server。

或

调用 SQLDriverConnect 以使用连接字符串连接到 SQL Server。

最低完整的 SQL Server 连接字符串有以下两种形式之一：
```
DSN=dsn_name;Trusted_connection=yes;  
DRIVER={SQL Server Native Client 10.0};SERVER=server;Trusted_connection=yes;  
```
如果连接字符串未完成， SQLDriverConnect 可以提示输入所需的信息。这由为 DriverCompletion 参数指定的值控制。

- 或 -

以迭代方式多次调用 SQLBrowseConnect ，以生成连接字符串并连接到 SQL Server。
（可选）调用 SQLGetInfo 以获取 SQL Server 数据源的驱动程序属性和行为。
分配和使用语句。
调用 SQLDisconnect 以断开与 SQL Server 的连接，并使连接句柄可用于新连接。
使用 HandleType SQL_HANDLE_DBC 调用 SQLFreeHandle 以释放连接句柄。
使用 HandleType SQL_HANDLE_ENV 调用SQLFreeHandle以释放环境句柄。

重要

请尽可能使用 Windows 身份验证。如果 Windows 身份验证不可用，则提示用户在运行时输入其凭据。避免将凭据存储在文件中。如果必须保留凭据，则应使用 Win32 加密 API 对其进行加密。

示例：

此示例演示了在不要求现有 ODBC 数据源的情况下连接到 SQLDriverConnect SQL Server 实例的调用。通过将不完整的连接字符串 SQLDriverConnect传递到其中，它会导致 ODBC 驱动程序提示用户输入缺失的信息。

#define MAXBUFLEN   255  
  
SQLHENV      henv = SQL_NULL_HENV;  
SQLHDBC      hdbc1 = SQL_NULL_HDBC;  
SQLHSTMT      hstmt1 = SQL_NULL_HSTMT;  
  
SQLCHAR      ConnStrIn[MAXBUFLEN] =  
         "DRIVER={SQL Server Native Client 10.0};SERVER=MyServer";  
  
SQLCHAR      ConnStrOut[MAXBUFLEN];  
SQLSMALLINT   cbConnStrOut = 0;  
  
// Make connection without data source. Ask that driver   
// prompt if insufficient information. Driver returns  
// SQL_ERROR and application prompts user  
// for missing information. Window handle not needed for  
// SQL_DRIVER_NOPROMPT.  
retcode = SQLDriverConnect(hdbc1,      // Connection handle  
                  NULL,         // Window handle  
                  ConnStrIn,      // Input connect string  
                  SQL_NTS,         // Null-terminated string  
                  ConnStrOut,      // Address of output buffer  
                  MAXBUFLEN,      // Size of output buffer  
                  &cbConnStrOut,   // Address of output length  
                  SQL_DRIVER_PROMPT);

通过

分配句柄并连接到 SQL Server （ODBC）

分配句柄并连接到 SQL Server

示例：

其他资源