Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter SixFile Functions (continued)

6.5 File System

6.5.1 Overview

Legato provides a series of SDK functions designed to access and manage file systems and file cloud components. The file system can generally be thought of as volumes that contain folders and files.

This section also covers functions dealing with the storage media in which the file systems reside.

Finally, path scoping is provided by BrowseAddSaveScope and BrowseAddOpenScope covered in chapter 9.

6.5.2 Volumes

Volumes are a logical way to organize storage hard drives, CDs or network drives. They contain a file system such as FAT or NTFS and may be physical, logical or virtual. For Legato and the application, volumes are either mapped drive letters, for example, C is normally mapped to the primary partition of a computer systems’ hard drive, mapped, such as a network drive mapped to a specific letter, such as ‘X’ or ‘N’. Volumes can also be accessed on the fly without a drive letter mapped by using an UNC (Universal/Uniform Naming Convention) in the form of ‘\\server\share\path’.

File clouds can be mapped by synchronizing an area on the computer’s hard drive, usually located in the user’s data area. While convenient, these methods generally have issues with locking files amongst users.

Finally, another form of cloud access is the Virtual File Cloud (VFC). Those are mounted or attached but only accessible to the current application session.

6.5.3 Virtual File Cloud

If the underlying application supports managed file cloud access, Legato provides functions for controlling such services. The embedded service is the Virtual File Cloud or VFC scheme.

The VFC consists of a local client manager and a remote server. The server generally employs an SQL style database to store information on one or more servers, or a cloud.

To use a VFC, it must be attached. This can be done via application settings, command line settings, or from a Legato SDK function. Once attached, VFC connections are attached like a web scheme.

When the VFC is employed, the file browse functions within the application will use the VFC browser rather than the Windows Explorer file browse.

6.5.4 Related Functions

Application

EnumerateOpenFiles — Enumerates files open by the application.

File Clouds:

AttachFileCloud — Attaches a file cloud.

EnumerateFileClouds — Enumerates all the attached file clouds.

GetFileCloudCount — Returns the number of defined file cloud connections.

GetFileCloudProperties — Gets the properties of a file cloud.

GetFileCloudRoot — Returns the root path string for a specified file cloud connection.

GetMaxFileClouds — Returns the maximum number of supported file cloud connections.

IsFileCloudEnabled — Tests whether the hosting application supports file clouds.

ReleaseFileCloud — Releases a specified file cloud.

SetFileCloudProperties — Allows certain file cloud properties to be changed on the fly for an existing connection.

Volume and Volume Control:

DoesVolumeSupportHidden — Tests whether a file volume supports hidden files.

DoesVolumeSupportRecycling — Tests whether a file volume supports recycled files.

DoesVolumeSupportWriting — Tests whether a file volume supports writing files (write protected).