AMX DESIGN XPRESS V 1.5 - PROGRAMMER GUIDE User's Guide download pdf (Page 274)

260

DAK

KwikNet Virtual File System

kvf_fsize kvf_fsize

Purpose Fetch the Size of a Virtual File

Used by

n Task o ISP o Timer Procedure o Restart Procedure n Exit Procedure

Setup Prototype is in file KN_FILES.H.

#include "KN_LIB.H"

#include "KN_FILES.H"

long kvf_fsize(const char *name);

Description Name is a filepath string providing the full path and file name of the virtual

file of interest. A virtual filename must begin with the volume base

assigned to a Virtual File System volume. The filepath must not be

ambiguous.

Returns If successful, a value of n is returned where n is the size of the virtual file

measured in bytes. If the virtual file has been compressed, the return

value n is the size of the expanded file. Note that a virtual file can be of

length 0.

If the virtual file specified by parameter name does not exist and there is

no underlying file system to handle the request, a value of -1L is returned.

Note If the parameter name does not reference a virtual file, the request is

passed on to the KwikNet Universal File System Interface. If an underlying

real file system exists, the file size is derived using the equivalent of the

fopen(), fseek() and ftell() functions. If, for any reason, the file size

cannot be derived, a value of -1L is returned.

No comments

AMX DESIGN XPRESS V 1.5 - PROGRAMMER GUIDE User's Guide Page 274