lld_create_client() 函数

此函数用于创建新的客户机文件。

语法

mi_integer lld_create_client(conn, path, error); 
      MI_CONNECTION*               conn
      mi_string*                   path;
      mi_integer*                  error;

int lld_create_client (char* path, int* error);

conn

先前通过调用 mi_open() 或 mi_server_connect() 函数建立的连接描述符。 此参数仅适用于 API 接口。在此函数的 ESQL/C 和 SQL 版本中，您必须已经连接到服务器。

path

指向客户机文件路径名的指针。

error

函数在其中返回错误代码的输出参数。

用途

此函数用于在客户机上创建文件。使用 lld_open_client() 函数打开文件进行读取或写入，并为其传递您传递到 lld_create_client() 的相同路径名。

除了智能大对象之外，Large Object Locator 不直接支持事务回滚。因此，如果用于调用 lld_create_client() 的事务已终止，那么应调用 lld_delete_client() 来删除对象并回收所有已分配的资源。

有关更多信息，请参阅大对象限制。

返回码

对于 API 函数，如果函数成功，将返回 MI_OK，如果失败，那么返回 MI_ERROR。

对于 ESQL/C 函数，如果函数成功，将返回 0，如果失败，那么返回 -1。

上下文