The ifx_lo_filename() function

Syntax

mint ifx_lo_filename(LO_ptr, fname, result, result_buf_nbytes)
   ifx_lo_t *LO_ptr;
   char *fname;
   char *result;
   mint result_buf_nbytes;

LO_ptr

A pointer to the LO-pointer structure that identifies the smart large object to copy. For more information about LO-pointer structures, see The LO-pointer structure

fname

The full path name of the target file to hold the data.

result

A pointer to a buffer that contains the file name that ifx_lo_copy_to_file() would generate.

result_len

The size, in bytes, of the result character buffer.

Usage

The ifx_lo_filename() function generates a file name from the fname argument that you provide. Use the ifx_lo_filename() function to determine the file name that the ifx_lo_filename() function would create for its fname argument.

fname.hex_id

However, you can specify wildcards in the fname argument that can change this default file name. You can use these wildcards in the fname argument of ifx_lo_filename() to see what file name these wildcards generate.

Return codes

0

The function was successful.

<0

The function was not successful and the return value indicates the cause of the failure.