Other Library Functions

Library: omvfs - virtual file system Include: omvfs.xin

Declaration

  define external function vfsChangeOwner
                 value  stream  path
       on        value  vfsDir  location  optional
       owner     value  stream  owner  optional
       group     value  stream  group  optional
       contents  value  switch  contents  optional  initial {VFS-NOT-INCLUDED}

  where:

  where

path

the file or directory name of the ownership change

location

a connected directory

owner

the new owner name

group

the new owning group

contents

specifies if the directory contents are also to have changed ownership

You use this function to change the owner of a file or subdirectory.

PARAMETERS

Path must be in one of the following formats:

• file name only
• file name plus an absolute directory path
• file name plus a relative directory path
• an absolute directory path
• a relative directory path

Contents value must be one of the following:

• VFS-NOT-INCLUDED
• VFS-INCLUDED

Location must be connected to a directory.

Location must be connected through the following scheme:

• File

OPERATION

• When location is supplied, path applies to that vfsDir.
• When location is not supplied, path applies to the current directory on the local file system.
• When contents is VFS-NOT-INCLUDED, only the specified file or directory has its ownership changed.
• When contents is VFS-INCLUDED and path is a directory reference, the directory, and all its contents have their ownership changed.

Sample function call:

  ; where vfsDir1 is a currently connected vfsDir variable 
  vfsChangeOwner "myPrograms.xom" on vfsDir1 owner "michelle" group "communications" 

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    vfsTruncate    vfsUnlock    vfsWrite

----

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

Copyright © OmniMark Technologies Corporation, 1988-2002.