SQLDriverConnect
功能描述
通过连接字符串或请求驱动程序管理器和驱动程序显示用户的连接对话框连接到特定驱动程序。
接口原型
RETCODE SQL_API
SQLDriverConnect(HDBC hdbc,
HWND hwnd,
SQLCHAR * szConnStrIn,
SQLSMALLINT cbConnStrIn,
SQLCHAR * szConnStrOut,
SQLSMALLINT cbConnStrOutMax,
SQLSMALLINT * pcbConnStrOut,
SQLUSMALLINT fDriverCompletion)
参数说明
| hdbc | 连接句柄 |
|---|---|
| hwnd | 窗口句柄。应用程序可以传递父窗口的句柄(如果适用)或null指针(如果窗口句柄不适用或SQLDriverConnect不会显示任何对话框) |
| szConnStrIn | 完整的连接字符串、部分连接字符串或空字符串。 |
| cbConnStrIn | szConnStrIn的长度（如果字符串为 Unicode，则以字符为单位;如果字符串为 ANSI 或 DBCS，则以字节为单位）。 |
| szConnStrOut | 指向已完成连接字符串的缓冲区的指针。 成功连接到目标数据源后，此缓冲区包含已完成的连接字符串。 应用程序应为此缓冲区至少分配 1，024 个字符。 |
| cbConnStrOutMax | szConnStrOut缓冲区 的长度（以字符表示）。 |
| pcbConnStrOut | 指向缓冲区的指针，在该缓冲区中可以返回*szConnStrOut中可用的字符总数(不包括null终止字符)。如果可返回的字符数大于或等于cbConnStrOutMax，则*szConnStrOut中的完整连接字符串将被截断为cbConnStrOutMax减去一个null终止字符的长度。 |
| fDriverCompletion | 指示驱动程序管理器或驱动程序是否必须提示输入更多连接信息的标志：SQL_DRIVER_PROMPT、SQL_DRIVER_COMPLETE、SQL_DRIVER_COMPLETE_REQUIRED 或 SQL_DRIVER_NOPROMPT。 |
返回值
- SQL_SUCCESS：表示调用正确。
- SQL_SUCCESS_WITH_INFO：表示会有一些警告信息。
- SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。
- SQL_INVALID_HANDLE：表示调用无效句柄。其他API的返回值同理。
其他
无。
