3.2.40 gbase_ping
摘要：
检查与服务器的连接是否工作。如果连接丢失，将自动尝试再连接。
该函数可被闲置了较长时间的客户端使用，用以检查服务器是否已关闭了
连接，并在必要时再次连接。
语法：
int gbase_ping(GBASE *gbase);
参数：
返回值：
如果与服务器的连接有效返回 0。如果出现错误，返回非 0 值。返回的非 0
值不表示 GBase 服务器本身是否已关闭，连接可能因其他原因终端，如网络问
题等。
3.2.41 gbase_query
摘要：
执行由“NULL 终结的字符串”查询指向的 SQL 查询。正常情况下，字符串
必须包含 1 条 SQL 语句，而且不应为语句添加终结分号（‘;’）或“\g”。如果
允许多语句执行，字符串可包含多条由分号隔开的语句。
gbase_query()不能用于包含二进制数据的查询，应使用
gbase_real_query()取而代之（二进制数据可能包含字符‘\0’，gbase_query()
会将该字符解释为查询字符串结束）。
语法：
int gbase_query(GBASE *gbase, const char *q);
参数：
返回值：
如果查询成功，返回 0。如果出现错误，返回非 0 值。
错误：
CR_COMMANDS_OUT_OF_SYNC 以不恰当的顺序执行了命令。
CR_SERVER_GONE_ERROR GBase 服务器不可用。
CR_SERVER_LOST 在查询过程中，与服务器的连接丢失。
CR_UNKNOWN_ERROR 出现未知错误。
3.2.42 gbase_real_connect
摘要：
gbase_real_connect()尝试与运行在主机上的GBase数据库引擎建立连接。
在你能够执行需要有效 GBase 连接句柄结构的任何其他 API 函数之前，
gbase_real_connect()必须成功完成。
语法：
GBASE * gbase_real_connect(GBASE *gbase,
const char *host,
const char *user,
const char *passwd,
const char *db,
unsigned int port,
const char *unix_socket,
unsigned long clientflag);
参数：
gbase 调用 gbase_real_connect()之前，必须调用 gbase_init()来
初始化 GBASE 结构。
host 必须是主机名或 IP 地址。如果“host”是 NULL 或字符串
"localhost"，连接将被视为与本地主机的连接。如果操作系
统支持套接字（Unix）或命名管道（Windows），将使用它们
而不是 TCP/IP 连接到服务器。如果使用支持集群 IP 路由的
GBase C API 连接 GBase 8a 数据库集群时，host 可以是包含
几个集群节点 IP 的字符串，IP 之间以“;”进行分割。这样
可以使用 GBase C API 的集群 IP 路由功能。
user 用户的 GBase 登录 ID。如果“user”是 NULL 或空字符串""，
用户将被视为当前用户。
passwd 用户的密码
db 数据库名称。如果 db 为 NULL，连接会将默认的数据库设为该
值。
port 如果“port”不是 0，其值将用作 TCP/IP 连接的端口号。注
意，“host”参数决定了连接的类型。
unix_socket 如果 unix_socket 不是 NULL，该字符串描述了应使用的套接
字或命名管道。注意，“host”参数决定了连接的类型。
clientflag 其值通常为 0，但是，也能将其设置为下述标志的组合，以允
许特定功能：
返回值：
如果连接成功，返回 GBASE*连接句柄。如果连接失败，返回 NULL。对于成
功的连接，返回值与第 1 个参数的值相同。
错误
