gbase数据、南大通用产品文档：GBase8sGCIThreadMutexRelease

sword GCIThreadMutexRelease (
void *hndl,
GCIError *err,
GCIThreadMutex *mutex
)；

释放互斥锁。如果互斥锁上有任何线程被阻塞，则其中一个线程会获取该线程并解除阻塞。
尝试释放未初始化的互斥锁是非法的。线程释放它不持有的互斥锁也是非法的。

参数
输入
/输出


hndl
输入/输出
GCI 环境或用户会话句柄
err
输入/输出
错误信息句柄，该接口调用失败时，错误信息会存在该句柄上
mutex
输入/输出
要释放的互斥锁

如果执行成功，返回 GCI_SUCCESS，否则返回 GCI_ERROR。

您必须为驱动程序设置的四个环境变量。
以下列表描述您必须为驱动程序设置的环境变量。要获取关于环境变量的更多信息，请参
阅《GBase 8s SQL 指南：参考》。
GBASEDBTDIR
安装 GBase 8s Client Software Development Kit 处的目录的完全路径。
在 Windows™ 平台上，GBASEDBTDIR 是注册设置，而不是环境变量。在安装期间设
置它。
PATH
搜索可执行程序的目录。PATH 的设置必须包括至 $GBASEDBTDIR/bin目录的路径。

DBCENTURY（可选的）
控制年值的设置。当用户发出包含仅指定年份的最后两个数字的 date 或
datetime 字符串的语句时，DBCENTURY影响客户机程序。例如：
insert into datetable (datecol) values ("01/01/01");
数据库服务器将此语句中指定的日期存储为 01-01-1901 或 01-01-2001，这取决
于客户机上的 DBCENTURY值。
GL_DATE（可选的）
GL_DATE 控制日期的解释。例如，您可指定日期格式为 mm-dd-yyyy 或
yyyy-mm-dd。
在 UNIX™ 上设置环境变量
如果您在命令行处设置环境变量，则每当登录至系统时，都必须重置它们。如果在文件中
设置环境变量，则当登录到系统时，会自动设置它们。
GBase 8s ODBC Driver 在 $GBASEDBTDIR/etc 中提供一个名为 setup.odbc 的样例设置
文件。您可使用此文件，来为驱动程序设置环境变量。下面列表描述 setup.odbc 中的环境
变量。
GBASEDBTDIR
安装 GBase 8s Client Software Development Kit 处的目录的完全路径。
GBASEDBTSQLHOSTS
此值是可选的。它指定包含 sqlhosts 的目录。在缺省情况下，sqlhosts 在
$GBASEDBTDIR/etc 中。如果想要 sqlhosts 在不同的目录中，则请设置
GBASEDBTSQLHOSTS。

GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 10 -
ODBCINI
此值是可选的。您可使用它来为 odbc.ini 文件指定替代的位置。缺省位置为您的
home 目录。

在 Windows 中设置环境变量
如果在命令行处设置环境变量，则必须在登录至 Windows™ 环境时重置它们。然而，如果
在 Windows 注册表中设置它们，则在登录时会自动设置。
GBase 8s ODBC Driver 在 Windows 注册表中的下列位置中存储环境变量：
\HKEY_CURRENT_USERS\Software\Gbasedbt\Environment
在 Windows 环境中，您必须使用 setnet32.exe 或直接更新注册表的工具，来设置诸如
iclit09b.dll 这样的 GBase 8s动态链接库（DLL）使用的环境变量。Setnet 实用程序只能用
于设置 GBase 8s 环境变量。
可根据开发环境的需要来使用环境变量。
例如，
编译器需要知道在哪里找到 include 文件。
要指定 include 文件的位置，请设置环境变量 GBASEDBTDIR（或某其他环境变量），然
后将 include 路径设置为 GBASEDBTDIR\incl\cli。
设置环境变量的选项有下列优先顺序：
1. Setnet 实用程序
2. 命令行
3. Windows 注册表

 摘要：
以结果集形式返回预处理语句元数据。
如果传递给gbase_stmt_prepare()的语句能够成生结果集，
gbase_stmt_result_metadata()将以指针的形式返回结果集元数据，该指针指
向GBASE_RES 结构，可用于处理元信息，如总的字段数以及单独的字段信息。
该结果集指针可作为参量传递给任何基于字段且用于处理结果集元数据的API
函数，如：
gbase_num_fields()
gbase_fetch_field()
gbase_fetch_field_direct()
gbase_fetch_fields()
gbase_field_count()

GBase 8a 程序员手册C API 篇


- 66 -

南大通用数据技术股份有限公司
gbase_field_seek()
gbase_field_tell()
gbase_free_result()
完成操作后，
应释放结果集结构，
可通过将其传递给gbase_free_result()
完成。它与释放通过gbase_store_result()调用获得的结果集的方法类似。
gbase_stmt_result_metadata()返回的结果集仅包含元数据。不含任何行
结果。与gbase_stmt_fetch()一起使用语句句柄，可获取行。
 语法：
GBASE_RES * gbase_stmt_result_metadata(GBASE_STMT *stmt);
 参数：
 返回值：
GBASE_RES结果结构。
如果不存在关于预处理查询的任何元信息，
返回NULL。

 错误
CR_OUT_OF_MEMORY


内存溢出。
CR_UNKNOWN_ERROR


出现未知错误。