User`s guide

262

DAK

KwikNet Virtual File System

kvf_open kvf_open

Purpose Open 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"

KN_VFILE *kvf_open(const char *name, const char *mode);

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

file to be opened. A virtual filename must begin with the volume base

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

ambiguous.

Mode is a string defining the type of file access which is required. Only

the following file access mode strings are allowed. Note that file writes

and text mode translations are not supported.

"r" Open for read (binary mode used)

"rb" Open for read using binary mode

"rt" Open for read using text mode (binary mode is used)

Returns If successful, a virtual file descriptor is returned and the file is opened.

On failure, a value of NULL is returned.

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

passed on via the KwikNet Universal File System Interface to the

underlying real file system, if one exists. In such a case, the return value

will be dictated by the equivalent fopen() function.