VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

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的返回值同理。