Tech Note 23: Using the File Library

December 01, 2008

© NSB Corporation. All rights reserved.

Introduction

The NSBFileLib Library contains functions that provide access to files in the phone memory and on storage cards.

The functions in this library are divided into the following categories:

Volume, Directory, File, File and Directory, Import/Export

This document, with its examples, should provide all the information necessary to use the functions in the NSBFileLib. In order to use the NSBFileLib Library, the library must be loaded using the NSBasic LoadLibrary statement. This statement should be located in the program's Startup code so that the functions will be available throughout the program. The LoadLibrary statement has an optional second parameter to allow you to specify an abbreviated reference name for the library's functions. The examples in this document use "Flib" for this reference name. Example:

Program's Startup code:

Sub main()
   LoadLibrary "NSBFileLib", "Flib"
End Sub

Also, in order to use the NSBFileLib Library, the NSBFileLib.INF file must be present in your "nsbasic_symbian\lib" directory and the NSBFileLib.prc file must be added to your project as a resource.

Storage on Symbian OS devices

The storage on Symbian OS devices is somewhat similar to Windows. Files are stored in directories. Each type of storage is a Volume: main memory is called "C:", while a memory card might be called "E:".

Using a utility like the Nokia PC Suite, it is easy to navigate the storage and see the volumes, directories and files. However, you will not see important system files and private directories. NS Basic/Symbian OS apps, like most apps, are installed into the Private directory. You cannot see them or files which may be installed with them from other applications.

This library lets you create and access files in the public storage area. It also lets you copy files from the public area to your own program's private area and back. It also lets you access files in multiple formats, including txt, csv and indeed, any data structure.

Function Index and Quick Reference

Internal Information
	Version	result = Version()
	GetLastError	result = GetLastError()
	Init	result = Init()

Volume functions
	BeginVolumeEnumerate	BeginVolumeEnumerate()
	GetNextVolume	volume = GetNextVolume()
	SetCurVolume	SetCurVolume(Integer volume)
	GetVolumeLabel	result = GetVolumeLabel()
	SetVolumeLabel	SetVolumeLabel(String label)
	IsVolumeReadOnly	result = IsVolumeReadOnly()
	IsVolumeHidden	result = IsVolumeHidden()
	VolumeUsedSize	size = VolumeUsedSize()
	VolumeTotalSize	size =VolumeTotalSize()
	VolumeFormat	VolumeFormat()
	GetVolumeMediaType	mediaType = GetVolumeMediaType()

Directory Functions
	DirCreate	DirCreate(dirName)
	BeginDirEntryEnumerate	BeginDirEntryEnumerate(dir)
	EndDirEntryEnumerate	EndDirEntryEnumerate()
	DirEntryEnumerate	FileOrDirName = DirEntryEnumerate()
	RegisterDefaultDirectory	RegisterDefaultDirectory(fileType,indexMediaType, path)
	UnregisterDefaultDirectory	UnregisterDefaultDirectory(fileType, indexMediaType)
	GetDefaultDirectory	path = GetDefaultDirectory(fileType)

File Functions
	IsEOF	eof = IsEof(fileRef)
	FileCreate	FileCreate(path)
	Read16	res = Read16(fileRef)
	Read32	res = Read32(fileRef)
	Read64	res = Read64(fileRef)
	ReadString	res = ReadString(fileRef)
	Write16	Write16(fileRef, data)
	Write32	Write32(fileRef,data)
	Write64	Write64(fileRef, data)
	WriteString	WriteString(fileRef, str)
	FileTell	pos = FileTell(fileRef)
	FileSize	size = FileSize(fileRef)
	FileResize	FileResize(fileRef, newSize)
	FileSeekBegin	FileSeekBegin(fileRef, offset)
	FileSeekCurrent	FileSeekCurrent(fileRef, offset)
	FileSeekEnd	FileSeekEnd(fileRef, offset)

File and directory functions
	Delete	Delete(path)
	Close	Close(fileRef)
	Rename	Rename(pathName, newName)
	SetDateCreated	SetDateCreated(fileRef, date)
	SetDateModified	SetDateModified(fileRef, date)
	SetDateAccessed	SetDateModified(fileRef, date)
	GetDateCreated	date = GetDateCreated(fileRef)
	GetDateModified	date = GetDateModified(fileRef)
	GetDateAccessed	date = GetDateAccessed(fileRef)
	SetAttributes	SetAttributes(fileRef, attributes)
	ResetAttributes	ResetAttributes(fileRef, attributes)
	GetAttributes	coinside = GetAttributes(fileRef, checkAttributes)
	Open	fileRef = Open(pathName, openMode)

Import/Export
	Import	dbName = Import(pathName)
	Export	Export(dbName, pathName)
	ImportDialog	dbName = ImportDialog(pathName, dialogTitle, actionStr)
	ExportDialog	ExportDialog(dbName, pathName , dialogTitle, actionStr)
Card Info
	GetDeviceUniqueIDStr	DeviceUniqueIDStr = GetDeviceUniqueIDStr

NSBFileLib Function Reference:

Internal Information

Version

version = Flib.Version()

Returns the version number of the NSBFileLib Library.

Returns

version as Integer

Example

Dim version as Integer 
version = Flib.Version()

GetLastError

error = Flib.GetLastError()

Returns an error of the last fullfilled lib function.

Returns

error as Integer.

Example

Dim err as Integer 
err = Flib.GetLastError()

Init

result = Flib.Init()

Must be called to initialize library. Returns 0 if successful.

Returns

result as Integer.

Example

Dim err as Integer 
err = Flib.Init()

Volume functions

BeginVolumeEnumerate

Flib.BeginVolumeEnumerate()

Initialize the lib before the enumeration of volumes.

Example

Flib.BeginVolumeEnumerate()

GetNextVolume

volume = Flib.GetNextVolume()

Returns next volume number. Returns correct volume ONLY if GetLastError returns 0.

Returns

volume as Integer.

Example

Global volRef(4) as Integer
Global numVol as Integer
Dim err as Integer
Dim i as Integer
list.clear
Flib.BeginVolumeEnumerate()
numVol = 0
Do
  i = Flib.GetNextVolume()
  err = Flib.GetLastError()
  If err = 0 Then
    numVol = numVol + 1
    volRef(numVol) = i
Else
    Exit Do
EndIf
Loop

SetCurVolume

Flib.SetCurVolume(volume)

Makes active chosen volume.

Parameter

volume as Integer.

Example

Flib.SetCurVolume(volRef(0))

GetVolumeLabel

label = Flib.GetVolumeLabel()

Returns label of the active volume

Returns

label as String.

Example

Dim label as String 
label = Flib.GetVolumeLabel()

SetVolumeLabel

Flib.SetVolumeLabel(label)

Sets label to an active volume

Parameter

label as string.

Example

Dim label as String 
label = "my volume label" 
Flib.SetVolumeLabel(label)

IsVolumeReadOnly

result = Flib.IsVolumeReadOnly()

Returns 1 if the active volume is read only.

Returns

result as Integer.

Example

Dim volumeReadOnly as Integer
Dim VROStr as String
volumeReadOnly = Flib.IsVolumeReadOnly()
VROStr = "Read/Write"
if volumeReadOnly = 1 then VROStr = "Read"

IsVolumeHidden

result = Flib.IsVolumeHidden()

Returns 1 if the active volume is hidden.

Returns

result as Integer.

Example

Dim volumeHidden as Integer
Dim HStr as String
volumeHidden = Flib.IsVolumeHidden()
HStr = "Visible"
if volumeHidden = 1 then HStr = "Hidden"

VolumeUsedSize

size = Flib.VolumeUsedSize()

Returns number of used bytes of the active volume.

Returns

size as Integer.

Example

Dim volUsedSize as Integer 
volUsedSize =Flib.VolumeUsedSize()

VolumeTotalSize

size = Flib.VolumeTotalSize()

Returns number of bytes of the active volume.

Returns

size as Integer.

Example

Dim volTotalSize as Integer  
volTotalSize= Flib.VolumeTotalSize()

VolumeFormat

Flib.VolumeFormat()

Formats the active volume.

Example

Flib.VolumeFormat()

GetVolumeMediaType

mediaType = Flib.GetVolumeMediaType()

Returns media type of the active volume.

Returns

mediaType as Integer.

Possible MEDIATYPEs

0 Matches all media types when looking up a default directory

1 Memory stick

2 Compact Flash

3 Secure Digital

4 MultiMedia Card

5 SmartMedia

6 A RAM disk based media

Example

Dim t(9) as String
Dim err as Integer
Dim m as Integer
t(1) = "Wild"
t(2) = "Memory stick"
t(3) = "Compact Flash"
t(4) = "Secure Digital"
t(5) = "MultiMedia Card"
t(6) = "SmartMedia"
m = Flib.GetVolumeMediaType()
fld.text = t(m+1)

Directory Functions

DirCreate

Flib.DirCreate(dirName)

Creates the directory with dirName at the active volume.

Parameter

dirName as string

Example

Dim path as Strin 
path = "/symbian/My directory/" 
Flib.DirCreate(path)

BeginDirEntryEnumerate

Flib.BeginDirEntryEnumerate(directory)

Initialize the lib before the enumeration of a directory.

Parameter

directory as String.

Example

Dim path as String 
path = "/symbian/My directory/" 
Flib.BeginDirEntryEnumerate(path)

EndDirEntryEnumerate

Flib.EndDirEntryEnumerate()

Must be called after enumeration for a normal flow of the program.

Example

Flib.EndDirEntryEnumerate()

DirEntryEnumerate

FileOrDirName = Flib.DirEntryEnumerate()

Enumerates the directory. Returns correct FileOrDirName ONLY if GetLastError returns 0.

Returns

FileOrDirName as String.

Example

Dim dir as String
Dim err as Integer
Dim name as String
dir = "/symbian/My directory/"
Flib.BeginDirEntryEnumerate(dir)
err = Flib.GetLastError
If err>0 Then GoTo ex
Do
name = Flib.DirEntryEnumerate()
err = Flib.GetLastError()    '10509 end of loop
If err > 0 Then Exit Do
lst.add name
Loop
ex:
Flib.EndDirEntryEnumerate

RegisterDefaultDirectory

Flib.RegisterDefaultDirectory(fileType, indexMediaType, path)

Registers a specific directory as the default location for files of a given type on a particular kind of external storage card. This function is generally called by a slot driver for files and media types that are supported by that slot driver. The file type may either be a MIME media type/subtype pair, such as "image/jpeg", “text/plain”, or “audio/basic”; or a file extension, such as “.jpeg.”.

Parameters

fileType as String, IndexMediaType as Integer, path as String.

indexMediaType see GetVolumeMediaType.

Example

Dim fileType as String
Dim indexMediaType as Integer
Dim path as String
fileType = ".txt"
indexMediaType = 3 'Secure Digital
path = "/text/"
Flib.RegisterDefaultDirectory(fileType, indexMediaType, path)

UnregisterDefaultDirectory

Flib.UnregisterDefaultDirectory(string fileType, integer indexMediaType)

Sever the association between a particular file type and a default directory for a given type of card media.

Parameters

fileType as String, indexMediaType as Integer.

Example

Dim fileType as String
Dim indexMediaType as Integer
fileType = ".txt"
indexMediaType = 3 'Secure Digital
Flib.UnregisterDefaultDirectory(fileType, indexMediaType)

GetDefaultDirectory

path = Flib.GetDefaultDirectory(fileType)

Determine the default location on the given volume for files of a particular type.

Parameter

fileType as String.

Returns

path as String

Example

Dim fileType as String
Dim path as String
fileType = ".txt"
path = Flib.GetDefaultDirectory(fileType)

File Functions

IsEOF

eof = Flib.IsEof(fileRef)

Returns 1 if the EOF of the opend file is reached and 0 otherwise.

Parameter

fileRef as Integer. Returns

eof as Integer.

Example

Dim sh as Short
Dim eof as Integer
Dim fileRef as Integer
...' open file
Do
sh = Flib.Read16(fileRef)
eof = Flib.IsEof(fileRef)
If eof = 1 Then Exit Do
Loop
...' close file

FileCreate

Flib.FileCreate(path)

Creates file. The full PATH is needed.

Parameter

path as String.

Example

Dim pathName as String 
pathName = "/symbian/My directory/Sample.txt" 
Flib.FileCreate(pathName)

Read16

res = Flib.Read16(fileRef)

Reads a short from the file specified by fileRef.

Parameter

fileRef as Integer. Returns

res as Short.

Example

Dim data16 as Short 
data16 = Flib.Read16(fileRef)

Read32

res = Flib.Read32(fileRef)

Reads a single from the file specified by fileRef.

Parameter

fileRef as Integer. Returns

res as Integer.

Example

Dim data32 as Integer 
data32 = Flib.Read32(fileRef)

Read64

res = Flib.Read64(fileRef)

Reads a double from the file specified by fileRef.

Parameter

fileRef as Integer. Returns

res as double.

Example

Dim data64 as Double 
data64 = Flib.Read64(fileRef)

ReadString

res = Flib.ReadString(fileRef)

Reads a string from the file specified by fileRef. Strings are null delimited: the read will continue until the first null byte (chr(0)).

Parameter

fileRef as Integer. Returns

res as String.

Example

Dim dataStr as String 
dataStr = Flib.ReadString(fileRef)

Write16

Flib.Write16(fileRef, data) Writes a short to the file specified by fileRef.

Parameters

fileRef as Integer, data as Short.

Example

Dim data16 as Short 
Flib.Write16(fileRef, data16)

Write32

Flib.Write32(fileRef, data)

Writes a single to the file specified by fileRef.

Parameters

fileRef as Integer, data as Integer.

Example

Dim data32 as Integer 
Flib.Write32(fileRef, data32)

Write64

Flib.Write64(fileRef, data)

Writes a double to the file specified by fileRef.

Parameters

fileRef as Integer, data as Double.

Example

Dim data64 as Double 
Flib.Write64(fileRef, data64)

WriteString

Flib.WriteString(Integer fileRef, string str)

Writes a string to the file specified by fileRef. Strings are null delimited: the write will continue until after the first null byte (chr(0)).

Parameters

fileRef as Integer, str as String.

Example

Dim dataStr as String 
Flib.WriteString(fileRef, dataStr)

FileTell

pos = Flib.FileTell(fileRef)

Returns position in the file specified by fileRef.

Parameter

fileRef as Integer. Returns

pos as Integer.

Example

Dim pos as Integer 
pos = Flib.FileTell(fileRef)

FileSize

size = Flib.FileSize(fileRef)

Returns size of the file specified by fileRef.

Parameter

fileRef as Integer. Returns

size as Integer.

Example

Dim size as Integer 
size = Flib.FileSize(fileRef)

FileResize

Flib.FileResize(fileRef, newSize)

Change (decrease) size of the file specified by fileRef. newSize is the new file size.

Parameters

fileRef as Integer, newSize as Integer.

Example

Dim newSize as Integer 
Flib.FileResize(fileRef, newSize)

FileSeekBegin

Flib.FileSeekBegin(fileRef, offset)

Positions offset bytes from the beginning of the file specified by fileRef.

Parameters

fileRef as Integer, offset as Integer.

Example

Dim offset as Integer 
offset = 10 
Flib.FileSeekBegin(fileRef, offset)

FileSeekCurrent

Flib.FileSeekCurrent(fileRef, offset)

Shifts offset bytes from the current position in the file specified by fileRef.

Parameters

fileRef as Integer, offset as Integer.

Example

Dim offset as Integer 
offset = 10 
Flib.FileSeekCurrent(fileRef, offset)

FileSeekEnd

Flib.FileSeekEnd(fileRef, offset)

Positions offset bytes backward from the end of the file specified by fileRef.

Parameters

fileRef as Integer, offset as Integer.

Example

Dim offset as Integer 
offset = 10 
Flib.FileSeekEnd(fileRef, offset)

File and directory functions

Delete

Flib.Delete(path)

Deletes closed file or directory specified by full path path.

Parameter

path as String.

Example

Dim path as String 
path = "/symbian/My directory/Sample.dat" 
Flib.Delete(path)

Close

Flib.Close(fileRef)

Closes file or directory specified by fileRef.

Parameter

fileRef as Integer.

Example

Flib.Close(fileRef)

Rename

Flib.Rename(pathName, newName)

Renames closed file or directory. It works ONLY within same directory. pathName is the full path, newName is the short one.

Parameters

pathName as String, newName as String.

Example

Dim pathName as String
Dim newName as String
pathName = "/symbian/My directory/Sample.dat"
newName = "Test.dat"
Flib.Rename(pathName, newName)

SetDateCreated

Flib.SetDateCreated(fileRef,date)

Sets the creation date of the file specified by fileRef.
Note: this function is not supported by all file systems.

Parameters

fileRef as Integer, date as Integer.

Example

Dim dateCreated as Integer
dateCreated = 123456789        ' seconds
Flib.SetDateCreated(fileRef,dateCreated)

SetDateModified

Flib.SetDateModified(fileRef, date)

Sets the modified date of the file specified by fileRef.
Note: this function is not supported by all file systems.

Parameters

fileRef as Integer, date as Integer.

Example

Dim dateModified as Integer
dateModified = 123456789        ' seconds
Flib.SetDateModified(fileRef,dateModified)

SetDateAccessed

Flib.SetDateAccessed(fileRef,date)

Sets the last access date of the file specified by fileRef
Note: this function is not supported by all file systems.

Parameters

fileRef as Integer, date as Integer.

Example

Dim dateAccessed as Integer
dateAccessed = 123456789        ' seconds
Flib.SetDateAccessed(fileRef,dateAccessed)

GetDateCreated

date = Flib.GetDateCreated(fileRef)

Returns the creation date of the file specified by fileRef.

Parameter

fileRef as Integer. Returns

date as Integer.

Example

Dim dateCreated as Integer 
dateCreated = Flib.GetDateCreated(fileRef)

GetDateModified

date = Flib.GetDateModified(fileRef)

Returns the modified date of the file specified by fileRef.

Parameter

fileRef as Integer. Returns

date as Integer.

Example

Dim dateModified as Integer 
dateModified = Flib.GetDateModified(fileRef)

GetDateAccessed

date = Flib.GetDateAccessed(fileRef)

Returns the last access date of the file specified by fileRef.

Parameter

fileRef as Integer. Returns

date as Integer.

Example

Dim dateAccessed as Integer 
dateAccessed = Flib.GetDateAccessed(fileRef)

SetAttributes

Flib.SetAttributes(fileRef, attributes)

Sets attributes of the file specified by fileRef.

Parameters

fileRef as Integer, attributes as Integer.

List of attributes

1 Read-only file or directory

2 Hidden file or directory

4 System file or directory

8 Volume label

16 Directory

32 Archived file or directory

64 Link to another file or directory

NOTE: SetAttributes subroutine must not be used to change
Volume label(8) and Directory(16) attributes

Example

Flib.SetAttributes(fileRef,2)' 2 - hidden

ResetAttributes

Flib.ResetAttributes(fileRef, attributes)

Resets attributes of the file specified by fileRef.

Parameters

fileRef as Integer, attributes as Integer.

NOTE: ResetAttributes subroutine must not be used to change
Volume label(8) and Directory(16) attributes

Example

Flib.ResetAttributes(fileRef,2)' 2 - hidden

GetAttributes

coinside = Flib.GetAttributes(fileRef, checkAttributes)

Returns attributes of the file or directory specified by fileRef.

Parameters

fileRef as Integer, checkAttributes as Integer. Returns

coinside as Integer.

Example

Dim coinside as Integer 
coinside = Flib.GetAttributes(fileRef, 2)' is it hidden?

Open

fileRef = Flib.Open(pathName, openMode)

Opens file or directory specified by full path pathName.

Parameters

pathName as String, openMode as Integer. Returns

fileRef as Integer.

OPENMODE constants

2 Open for read access

3 Open and lock for read access

7 Open and lock for read/write access

15 Open and lock for read/write access; create if file not exists

Example

Dim pathName as String
Dim fileRef as Integer
pathName ="/symbian/My directory/Sample.dat"
fileRef = Flib.Open(pathName,7)

Import/Export

Import

dbName = Flib.Import(pathName)

Copies a file from the public directory to the app's private directory.

Parameter

pathName as String is the full path for .pdb or .prc. Returns

dbName as String.

Example

Dim pathName as String
Dim dbName as String
pathName="/symbian/My directory/Puzzle.prc"
dbName = Flib.Import(pathName)

Export

Flib.Export(dbName, pathName)

Copies a file from the application's private area to a public directory.

Parameters

dbName as String is the database name, pathName as String is the full path for .pdb or .prc.

Example

Dim pathName as String
Dim dbName as String
dbName="15-Puzzle"
pathName="/symbian/My directory/Puzzle.prc"
Flib.Export(dbName, pathName)

ImportDialog

dbName = Flib.ImportDialog(pathName, dialogTitle, actionStr)

Copies a file from the public directory to the app's private directory.
This function differs from Import in that it allows you to cancel the import operation.

Parameters

pathName as String is the full path for .pdb or .prc., dialogTitle as String is the title of dialog, actionStr as String is the dialog message. Returns

dbName as String.

Example

Dim pathName as String
Dim dbName as String
Dim dialogTitle as String
Dim actionStr as String
pathName="/symbian/My directory/Puzzle.prc"
dialogTitle="Import file"
actionStr="Importing Puzzle.prc"
dbName = Flib.ImportDialog(pathName, dialogTitle, actionStr)

ExportDialog

Flib.ExportDialog(dbName, pathName , dialogTitle, actionStr)

Copies a file from the application's private area to a public directory.
This function differs from Export in that it allows you to cancel the export operation.

Parameters

dbName as String is the database name, pathName as String is the full path for .pdb or .prc, dialogTitle as String is the title of dialog, actionStr as String is the dialog message.

Example

Dim pathName as String
Dim dbName as String
Dim dialogTitle as String
Dim actionStr as String
dbName="15-Puzzle"
pathName="/symbian/My directory/Puzzle.prc"
dialogTitle="Export file"
actionStr="Exporting "
actionStr= actionStr + dbName
Flib.ExportDialog(dbName,pathName , dialogTitle, actionStr)

Card Info

GetDeviceUniqueIDStr

DeviceUniqueIDStr = Flib.GetDeviceUniqueIDStr

Returns unique identifier for the product of the external storage card. A serial number for example. This value is set to the empty string if no identifier exist.

Returns

DeviceUniqueIDStr as String.

Example

Dim GetDeviceUniqueIDStr as String
GetDeviceUniqueIDStr = Flib.GetDeviceUniqueIDStr

Error codes

0	errNone	No error
537	dmErrAlreadyExists	Another database with the same name already exists in RAM store.
1282	sysErrParamErr	Wrong input parameter
10497	expErrUnsupportedOperation	unsupported or undefined opcode and/or creator
10498	expErrNotEnoughPower	the required power is not available
10499	expErrCardNotPresent	no card is present
10500	expErrInvalidSlotRefNum	slot reference number is bad
10501	expErrSlotDeallocated	slot reference number is within valid range, but has been deallocated
10502	expErrCardNoSectorReadWrite	the card does not support the SlotDriver block read/write API
10503	expErrCardReadOnly	the card does support R/W API but the card is read only
10504	expErrCardBadSector	the card does support R/W API but the sector is bad
10505	expErrCardProtectedSector	The card does support R/W API but the sector is protected
10506	expErrNotOpen	slot driver library has not been opened
10507	expErrStillOpen	slot driver library is still open - maybe it was opened > once
10508	expErrUnimplemented	Call is unimplemented
10509	expErrEnumerationEmpty	No values remaining to enumerate
10510	expErrIncompatibleAPIVer	The API version of this slot driver is not supported by this version of ExpansionMgr.
10753	vfsErrBufferOverflow	passed in buffer is too small
10754	vfsErrFileGeneric	Generic file error.
10755	vfsErrFileBadRef	the fileref is invalid (has been closed, or was not obtained from Flib.Open() )
10756	vfsErrFileStillOpen	returned from Flib.Delete if the file is still open
10757	vfsErrFilePermissionDenied	The file is read only
10758	vfsErrFileAlreadyExists	a file of this name exists already in this location
10759	vfsErrFileEOF	file pointer is at end of file
10760	vfsErrFileNotFound	file was not found at the path specified
10761	vfsErrVolumeBadRef	the volume refnum is invalid
10762	vfsErrVolumeStillMounted	returned if the volume is still mounted
10763	vfsErrNoFileSystem	no installed filesystem supports this operation
10764	vfsErrBadData	operation could not be completed because of invalid data (i.e., import DB from .PRC file)
10765	vfsErrDirNotEmpty	can't delete a non-empty directory
10766	vfsErrBadName	invalid filename, or path, or volume label or something...
10767	vfsErrVolumeFull	not enough space left on volume
10768	vfsErrUnimplemented	this call is not implemented
10769	vfsErrNotADirectory	This operation requires a directory
10770	vfsErrIsADirectory	This operation requires a regular file, not a directory
10771	vfsErrDirectoryNotFound	Returned from Flib.FileCreate when the path leading up to the new file does not exist
10772	vfsErrNameShortened	A volume name or filename was automatically shortened to conform to filesystem spec

Possible MEDIATYPEs
0	Matches all media types when looking up a default directory
1	Memory stick
2	Compact Flash
3	Secure Digital
4	MultiMedia Card
5	SmartMedia
6	A RAM disk based media

List of attributes
1	Read-only file or directory
2	Hidden file or directory
4	System file or directory
8	Volume label
16	Directory
32	Archived file or directory
64	Link to another file or directory

OPENMODE constants
2	Open for read access
3	Open and lock for read access
7	Open and lock for read/write access
15	Open and lock for read/write access; create if file not exists