文档中心

SQLDriverConnect函数 ​

功能 ​

根据用户的需求，设置连接属性，新建连接。

函数原型 ​

C
SQLRETURN SQLDriverConnect(
      SQLHDBC 			ConnectionHandle,
      SQLHWND 			WindowHandle,
      SQLCHAR *		 	InConnectionString,
      SQLSMALLINT 		StringLength1,
      SQLCHAR * 		OutConnectionString,
      SQLSMALLINT 		BufferLength,
      SQLSMALLINT * 	StringLength2Ptr,
      SQLUSMALLINT 		DriverCompletion);

参数解释 ​

  • ConnectionHandle：连接句柄。
  • WindowHandle：窗口句柄。
  • InConnectionString：连接属性串，用户可选择DSN，并在此设置更改需要的连接参数属性。
  • StringLength1：以字节为单位描述连接串属性长度，可以选填默认值SQL_NTS。
  • OutConnectionString：连接输出信息串，本字符串包含完全连接的信息，注意申请相应的内存。
  • BufferLength：输出连接串的最大长度。
  • StringLength2Ptr：以字节为单位描述连接输出信息串长度，可选填默认值SQL_NTS。
  • DriverCompletion：指示完成标识，指示是否驱动需要提供更多的连接参数信息。

返回值 ​

成功时返回SQL_SUCCESS。