SQLDriver
功能描述
返回已安装的驱动程序及其属性的列表。此函数仅由驱动程序管理器实现。
接口原型
SQLRETURN SQLDrivers(
SQLHENV EnvironmentHandle,
SQLUSMALLINT Direction,
SQLCHAR * DriverDescription,
SQLSMALLINT BufferLength1,
SQLSMALLINT * DescriptionLengthPtr,
SQLCHAR * DriverAttributes,
SQLSMALLINT BufferLength2,
SQLSMALLINT * AttributesLengthPtr);
参数说明
| 参数名 | 参数说明 |
|---|---|
| EnvironmentHandle | 环境句柄 |
| Direction | 确定驱动程序管理器是否提取列表中下一个驱动程序 (SQL_FETCH_NEXT) 搜索是否从列表开头开始 (SQL_FETCH_FIRST) 。 |
| DriverDescription | 指向要返回驱动程序说明的缓冲区的指针。 |
| BufferLength1 | DriverDescription 缓冲区的长度（以字符表示）。 |
| DescriptionLengthPtr | 指向一个缓冲区的指针，在该缓冲区中，可以返回*DriverDescription中可用的字符总数(不包括null-termination字符)。如果可返回的字符数大于或等于BufferLength1， *DriverDescription中的驱动描述将被截断为BufferLength1减去一个null字符的长度。 |
| DriverAttributes | 指向缓冲区的指针，在缓冲区中返回驱动程序属性值对。 |
| BufferLength2 | * DriverAttributes 缓冲区 的长度（以字符表示）。 |
| AttributesLengthPtr | 一个缓冲区的指针，在这个缓冲区中，可以返回*DriverAttributes中可用的总字节数(不包括null终止字节)。如果返回的字节数大于或等于BufferLength2，则*DriverAttributes中的属性值对列表被截断为BufferLength2减去null终止字符的长度。 |
返回值
- SQL_SUCCESS：表示调用正确。
- SQL_SUCCESS_WITH_INFO：表示会有一些警告信息。
- SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。
- SQL_INVALID_HANDLE：表示调用无效句柄。其他API的返回值同理。
- SQL_NO_DATA: 表示没有对应的数据。
其他
该接口仅由驱动管理器实现，因此直接采用驱动管理器实现的接口原型。
