Library: File system utilities (OMVFS) legacy Include: omvfs.xin

Declaration

define external function vfsUnlock
         value  vfsFile  file
     id  value  integer  lock-id  optional

Argument definitions

file

is the vfsFile object associated with the file to be unlocked.

lock-id

is the identifier of a single locked section.

Use vfsUnlock to unlock a file. A single locked section or the entire file may be unlocked.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "omvfs.xin"

file must be open (else external exception VFS200).

lock-id must be the ID of an existing lock on the specified file (else external exception VFS218).

Usage Notes

If lockid is

• specified, the lock associated lock-id is removed
• not specified, all locks on the file are removed. (Unless there are no locks on the file, in which case no action is performed.)

External exception VFS300 is thrown for any general OS operation failure. The text accompanying the exception will contain details on the reason for the failure.

Example: Removing a specific lock from a file

This program shows a lock being set and then removed.

    include "omvfs.xin"
  
    process
       local vfsFile myFile2
       local integer myLock
       	. . .
       set myFile2 to vfsOpen "myfile.txt"
       	. . .
       vfsLock myFile2
       	from VFS-START to 800
    	id myLock
       	. . .
       vfsUnlock myFile2
    	id myLock

Other Library Functions    vfsChangeDir    vfsChangeOwner    vfsChangePermissions    vfsClose    vfsConnect    vfsConnectDir    vfsCopy    vfsCursorPosition    vfsDeleteDir    vfsDeleteFile    vfsDescribe    vfsDescribeFile    vfsDir    vfsDirName    vfsDisconnect    vfsFile    vfsFileDir    vfsFileName    vfsIsVersionCompatible    vfsLibraryVersion    vfsLink    vfsList    vfsLock    vfsMakeDir    vfsMove    vfsMoveCursor    vfsOpen    vfsRead    vfsRename    vfsTruncate    vfsUnlock    vfsWrite

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]