Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter SixFile Functions (continued)

GetVolumeSize Function

Overview

The GetVolumeSize function retrieves the amount of total space available (used and free) on a volume to the user owning the process thread.

Syntax/Parameters

Syntax

qword = GetVolumeSize ( string volume );

Parameters

volume

A string containing the disk, volume, or UNC designation. If this parameter is a UNC name, it must include a trailing backslash (for example, “\\MyServer\MyShare\”).

Return Value

Returns a qword specifying the space available to the user or zero on failure. Use the GetLastError function to retrieve error information.

Remarks

The volume parameter does not have to specify the root directory on a disk. Any directory on the disk is acceptable. The calling application must have FILE_LIST_DIRECTORY access rights for this directory.

The GetVolumeSize function returns zero for all CD requests unless the disk is an unwritten CD in a CD-RW drive. When retrieving the volume space of a network share, the size may be reflected in any number of network shares since it is usually reported as the total space of the volume where the share is located.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic