FClose Function (ROM Call 0x3D5)

AMS 2.00 or higher files.h

unsigned short FClose (FILES *fsPtr);

Close a file.

FClose closes the file fsPtr. This is required for files opened in WRITE mode. For files in READ mode, FClose just updates the fsPtr->fileMode and fsPtr->fileStatus fields in the FILES structure.

fsPtr is a pointer to a FILES structure that was previously opened with FOpen.

FClose returns FS_OK if the file was successfully closed. There is extra overhead required for a file that is always kept around by the file system and so closing a file will only return an error if the file or the heap has been damaged.


Uses: HeapRealloc, HeapSize, strlen, DerefSym
Used by: FCreate


See also: FAccess, FOpen, FStatus