SQLGetFunctions
功能描述
SQLGetFunctions 返回有关驱动程序是否支持特定 ODBC 函数的信息。 此函数在驱动程序管理器中实现;它还可以在驱动程序中实现。 如果驱动程序实现 SQLGetFunctions, 驱动程序管理器将调用驱动程序中的 函数。 否则,它将执行函数本身。
接口原型
RETCODE SQL_API
SQLGetFunctions(HDBC ConnectionHandle,
SQLUSMALLINT FunctionId,
SQLUSMALLINT *Supported)
参数说明
参数名 | 参数说明 |
---|---|
ConnectionHandle | 连接句柄 |
FunctionId | 一个#define值,用于标识别具体调用的ODBC函数。当FunctionId为SQL_API_ODBC3_ALL_FUNCTIONS时候调用PGAPI_GetFunctions30;否则调用PGAPI_GetFunctions。 |
Supported | 如果 FunctionId 标识单个 ODBC 函数, 则 Supported指向单个 SQLUSMALLINT 值。SQL_TRUE如果:驱动程序支持指定函数; 驱动程序不支持指定函数。 如果 FunctionId 为SQL_API_ODBC3_ALL_FUNCTIONS,Supported 将指向一个 SQLSMALLINT 数组,该数组具有多个等于SQL_API_ODBC3_ALL_FUNCTIONS_SIZE。 驱动程序管理器将此数组视为 4,000 位位图,该位图可用于确定是否支持 ODBC 3 .x 或更早的函数。 调用 SQL_FUNC_EXISTS 宏以确定函数支持。ODBC 3 .x 应用程序可以针对 ODBC 3 .x SQL_API_ODBC3_ALL_FUNCTIONS ODBC 2 .x 驱动程序调用具有 SQL_API_ODBC3_ALL_FUNCTIONS 的 SQLGetFunctions。 如果FunctionId是SQL_API_ALL_FUNCTIONS, Supported指向一个包含100个元素的SQLUSMALLINT数组。数组由FunctionId用来标识每个ODBC函数的#define值作为索引;数组中的一些元素是未使用的,并保留以供将来使用。 |
返回
- SQL_SUCCESS:表示调用正确。
- SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
- SQL_ERROR:表示比较严重的错误,如:内存分配失败、建立连接失败等。
- SQL_INVALID_HANDLE:表示调用无效句柄。其他API的返回值同理。