lld_create_client()

API

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

ESQL/C

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

conn: is 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 version of this function, you must already be connected to a server.
path: is a pointer to the pathname of the client file.
error: is 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 Transaction Rollback 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.