SQLGetInfo
功能描述
返回有关特定驱动程序和数据源的信息。
接口原型
RETCODE SQL_API
SQLGetInfo(HDBC ConnectionHandle,
SQLUSMALLINT InfoType,
PTR InfoValue,
SQLSMALLINT BufferLength,
SQLSMALLINT *StringLength)
参数说明
参数名 | 参数说明 |
---|---|
ConnectionHandle | 连接句柄 |
InfoType | 信息类型,类型过多不做列举 |
InfoValue | 指向要返回信息的缓冲区的指针。根据请求的InfoType,返回的信息将是以下信息之一:一个以空字符结束的字符串、一个sqlumallint值、一个SQLUINTEGER位掩码、一个SQLUINTEGER标志、一个SQLUINTEGER二进制值或一个SQLULEN值。 |
BufferLength | infoValue 缓冲区 的长度。 如果 infoValue 中的值不是字符串,或者 InfoValue是 null 指针,则 忽略 BufferLength 参数。 驱动程序假定InfoValue 的大小是 SQLUSMALLINT 或 SQLUINTEGER。 |
StringLength | 指向一个缓冲区的指针,在该缓冲区中可以返回InfoValue中可用的总字节数(不包括字符数据的空终止字符)。 对于字符数据,如果可返回的字节数大于或等于BufferLength,则InfoValue中的信息将被截断为BufferLength字节减去null字符的长度,并被驱动程序以null结尾。 |
返回
- SQL_SUCCESS:表示调用正确。
- SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
- SQL_ERROR:表示比较严重的错误,如:内存分配失败、建立连接失败等。
- SQL_INVALID_HANDLE:表示调用无效句柄。其他API的返回值同理。
其他
无。