SQLDriverConnect 函数 (CLI)-连接到数据源

SQLRETURN  SQLDriverConnect (
        SQLHDBC       ConnectionHandle,               /* hdbc */
        SQLHWND       WindowHandle,                   /* hwnd */
        SQLCHAR       *InConnectionString,            /* szConnStrIn */
        SQLSMALLINT   InConnectionStringLength,       /* cbConnStrIn */
        SQLCHAR       *OutConnectionString,           /* szConnStrOut */
        SQLSMALLINT   OutConnectionStringCapacity,    /* cbConnStrOutMax */
        SQLSMALLINT   *OutConnectionStringLengthPtr,  /* pcbConnStrOut */
        SQLUSMALLINT  DriverCompletion);              /* fDriverCompletion */

InConnectionString由有效的连接字符串组成。 连接字符串具有以下语法:

DRIVER=driver_name

数据库驱动程序的名称。 您可以使用 SQLDrivers() 函数获取数据库驱动程序的名称。

DSN=dsn_name

要连接到的数据源的名称。 除非 DriverCompletion 自变量等于 SQL_DRIVER_NOPROMPT 或指定了 DATABASE 关键字值，否则连接需要 DSN 关键字值。

DATABASE=database_name

数据库标识。 数据库名称可以仅由数据库名称组成，也可以由数据库名称，服务器名称和端口号组成。 如果未提供服务器名称和端口号，那么将使用缺省值。 缺省服务器名称为 LOCALHOST ，缺省端口号为 50000。 除非 DriverCompletion 自变量等于 SQL_DRIVER_NOPROMPT 或指定了 DSN 关键字值，否则连接需要 DATABASE 关键字值。

UID

为连接认证请求指定的用户标识。

PWD

对应于指定用户标识的密码。

NEWPWD

用作更改密码请求的一部分的新密码。 如果未将 DriverCompletion 自变量设置为 SQL_DRIVER_NOPROMPT，那么可以在连接字符串中指定新密码，或者在连接字符串中为新密码提示指定 NEWPWD=; 。

CLI_keyword

用于配置 CLI 驱动程序行为的 CLI 配置关键字。 如果在连接字符串中多次指定了任何 CLI 关键字，那么将使用第一次出现的关键字。

对于连接字符串关键字 ( PWD 和 NEWPWD 关键字除外) 及其值，请避免使用以下字符:

• 开口支架 ([)
• 右括号 (])
• 左花括号 ({)
• 右花括号 (})
• 逗号 (，)
• 分号 (;)
• 问号（?）
• 星号 (*)
• 等号 (=)
• 感叹号 (!)
• At 符号 (@)
• 反斜杠 (\)

CLI 驱动程序支持 PWD 和 NEWPWD 关键字的特殊字符，但存在一些限制。 请参阅相关参考中的 "驱动程序和 CLPPlus 的密码规则" 主题以获取详细信息。

DriverCompletion 参数的以下值确定 CLI 驱动程序是否提示用户获取更多信息:

SQL_DRIVER_COMPLETE

仅当连接字符串中的信息不足时，才会启动对话。 连接字符串中的信息用作初始值，并由提示用户时输入的数据进行补充。

SQL_DRIVER_COMPLETE_REQUIRED

仅当连接字符串中的信息不足时，才会启动对话。 连接字符串中的信息用作初始值。 系统仅提示用户输入必需的信息。

SQL_DRIVER_NOPROMPT

系统不会提示用户输入任何信息。 尝试使用连接字符串中的信息进行连接。 如果没有足够的信息，那么将返回 SQL_ERROR 消息。

SQL_DRIVER_PROMPT

将始终启动对话。 连接字符串和 CLI 初始化文件中的信息将用作初始值。