The lld_create_client() function

This function creates a new client file.

Syntax

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

The connection descriptor established by a previous call to the mi_open() or mi_server_connect() functions. This parameter is for the API interface only. In the ESQL/C and SQL versions of this function, you must already be connected to a server.

path

A pointer to the path name of the client file.

error

An output parameter in which the function returns an error code.

Usage

This function creates a file on your client machine. Use the lld_open_client() function to open the file for reading or writing and pass it the same pathname as you passed to lld_create_client().

Large Object Locator does not directly support transaction rollback, except for smart large objects. Therefore, if the transaction in which you call lld_create_client() is aborted, you should call lld_delete_client() to delete the object and reclaim any allocated resources.

See Large object requirements for more information.

Return codes

For an API function, returns MI_OK if the function succeeds and MI_ERROR if it fails.

For an ESQL/C function, returns 0 if the function succeeds and -1 if the function fails.

Context